التثبيت

تثبيت 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] الإضافة الإضافية قبل استخدام وظائف 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
...

التبعيات

المكتبة الأساسية تحتوي على صفر تبعيات إلزامية من الطرف الثالث. جميع تحليل الثنائيات لـ MS-ONE/OneStore يتم تنفيذه في Python نقي داخل الـ aspose.note._internal الحزمة الفرعية.

تفاصيل الحزمة

موارد إضافية

• Aspose.Note FOSS for Python: PyPI
• مستودع المصدر
• الإبلاغ عن المشكلات
• دليل المطور
• مرجع API