نصب
نصب Aspose.Note FOSS برای Python
Aspose.Note FOSS for Python is distributed via PyPI زیر نام بسته aspose-note. نصب نیاز به Python 3.10 یا بالاتر دارد.
1. Standard Install (Recommended)
کتابخانهٔ اصلی را با pip نصب کنید:
pip install aspose-noteاین نصب میکند aspose.note بسته بدون هیچ وابستگی اختیاری. تمام ویژگیهای خواندن و پیمایش را پشتیبانی میکند. صدور PDF است نیست شامل شده است.
2. Install with PDF Export Support
برای فعالسازی Document.Save(..., SaveFormat.Pdf), با نصب [pdf] افزونگی. این اضافه میکند ReportLab وابستگی (reportlab>=3.6):
pip install "aspose-note[pdf]"اگر قبلاً بستهٔ اصلی را نصب کردهاید، آن را بهروزرسانی کنید و افزونه را در یک فرمان اضافه کنید:
pip install --upgrade "aspose-note[pdf]"توجه: تلاش برای فراخوانی Document.Save با SaveFormat.Pdf بدون نصب ReportLab باعث بروز یک ImportError در زمان اجرا میشود. نصب کنید [pdf] extra قبل از استفاده از قابلیت PDF.
3. Virtual Environment (Best Practice)
از یک محیط مجازی برای جداسازی کتابخانه از Python سیستم خود استفاده کنید:
##Create a virtual environment
python -m venv .venv
##Activate it
##Windows:
.venv\Scripts\activate
##Linux / macOS:
source .venv/bin/activate
##Install (with PDF support)
pip install "aspose-note[pdf]"4. Editable Install (For Contributors)
مخزن را کلون کنید و بهصورت قابل ویرایش نصب کنید تا بتوانید توسعه دهید یا تستها را بر روی منبع اجرا کنید:
git clone https://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python.git
cd Aspose.Note-FOSS-for-Python
##Editable install with PDF support
pip install -e ".[pdf]"
##Run the test suite
python -m unittest discover -s tests -p "test_*.py" -vتأیید
پس از نصب، تأیید کنید که بسته قابل ایمپورت است:
from aspose.note import Document, SaveFormat, FileFormat
print("Aspose.Note FOSS for Python installed successfully.")نسخهٔ نصبشده را بررسی کنید:
pip show aspose-noteخروجی مورد انتظار (نسخه ممکن است متفاوت باشد):
Name: aspose-note
Version: 26.3.2
Summary: Aspose.Note-compatible Python API for reading OneNote (.one) files
...وابستگیها
| وابستگی | ضروری؟? | هدف |
|---|---|---|
| Python 3.10+ | همیشه | حداقل نسخه زبان |
reportlab>=3.6 | اختیاری (از طریق [pdf] اضافی) | صادرات PDF از طریق Document.Save(..., SaveFormat.Pdf) |
کتابخانهٔ هستهای دارد هیچ وابستگی اجباری شخص ثالثی وجود ندارد. تمام تجزیه و تحلیل باینری MS-ONE/OneStore بهصورت خالص Python در the aspose.note._internal زیرپکیج.
جزئیات بسته
| ویژگی | مقدار |
|---|---|
| نام بسته | aspose-note |
| آدرس PyPI | https://pypi.org/project/aspose-note/ |
| مسیر وارد کردن | from aspose.note import ... |
| نسخه (فعلی) | 26.3.2 |
| پشتیبانی Python | 3.10, 3.11, 3.12 |
| سیستمعاملها | ویندوز، لینوکس، macOS (بدون وابستگی به سیستمعامل) |
| مجوز | MIT (Aspose-Split) |
| مخزن منبع | https://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python |
