GroupDocs.Conversion for Python v26.3 متاح الآن. يضيف هذا الإصدار تحويلًا حسب الصفحة، إخراجًا في الذاكرة (stream)، دعمًا لـ Python 3.14، ملفات دمج وكيل الذكاء الاصطناعي، تحسينات على بيانات تعريف الصيغ، والعديد من التحسينات.
ما الجديد في هذا الإصدار
| المفتاح | الفئة | الملخص |
|---|---|---|
| CONVERSIONPYTHON-65 | ميزة | تحويل حسب الصفحة عبر convert_by_page(output_dir, convert_options) |
| CONVERSIONPYTHON-66 | ميزة | تحويل في الذاكرة عبر convert_to_stream(convert_options) |
| CONVERSIONPYTHON-62 | ميزة | دعم Python 3.14 |
| CONVERSIONPYTHON-64 | ميزة | تضمين ملف AGENTS.md داخل الحزمة لدمج وكيل الذكاء الاصطناعي |
| CONVERSIONPYTHON-67 | تحسين | كائنات الصيغ تعرض خصائص .extension، .file_format، .description |
| CONVERSIONPYTHON-68 | تحسين | مصنف macOS صريح في بيانات تعريف PyPI |
تغييرات في API العامة
طرق وظيفية جديدة – تم الإعلان عن هذه الطرق في 25.12 لكنها كانت تُثير NotImplementedError. أصبحت الآن عملية:
| الطريقة | الإرجاع | الوصف |
|---|---|---|
Converter.convert_by_page(output_dir, convert_options) |
None |
يقسم المستند إلى ملف واحد لكل صفحة في الدليل المحدد |
Converter.convert_to_stream(convert_options) |
bytes |
يحول المستند ويعيد النتيجة كـ bytes في الذاكرة |
طرق غير متاحة بعد – الطرق التالية موجودة كوكيلات للخصائص على فئة Converter لكنها غير عملية في ربط Python. استدعاؤها سيؤدي إلى استثناء:
| الطريقة | الحالة | الحل البديل |
|---|---|---|
convert_by_page(file_path, page_number, convert_options) |
TypeError — التحميل ذو 3 وسائط غير معروض |
استخدم convert_options.page_number + convert_options.pages_count = 1 مع convert(file_path, options) |
convert_by_page(stream, page_number, convert_options) |
TypeError — التحميل ذو 3 وسائط غير معروض |
حوّل إلى ملف، ثم اقرأه إلى io.BytesIO |
convert_multiple(folder_path, convert_options) |
MissingMethodException |
استخدم convert(file_path, options) لإخراج ملف موحد من الأرشيفات |
ميزات جديدة
تحويل حسب الصفحة – convert_by_page
طريقة Converter.convert_by_page(output_dir, convert_options) أصبحت الآن عملية بالكامل. تقسم مستندًا متعدد الصفحات إلى ملفات إخراج فردية — ملف لكل صفحة — تُحفظ في الدليل المحدد. تُسمى ملفات الصفحات page_1.ext، page_2.ext، وهكذا. تعمل هذه الطريقة مع جميع فئات ConvertOptions التي تدعم الإخراج القائم على الصفحات، مثل ImageConvertOptions، PdfConvertOptions، WordProcessingConvertOptions، PresentationConvertOptions، وغيرها.
تحويل في الذاكرة – convert_to_stream
طريقة Converter.convert_to_stream(convert_options) الآن تُعيد المستند المحول ككائن bytes في Python، مما يتيح خطوط تحويل في الذاكرة دون كتابة إلى القرص. هذا مفيد للوظائف السحابية، تطبيقات الويب، والهندسة المعمارية التي تعتمد على البث حيث يكون الوصول إلى نظام الملفات محدودًا أو غير مرغوب فيه.
دعم Python 3.14
تم توسيع نطاق إصدارات Python المدعومة من 3.5–3.13 (25.12) إلى 3.5–3.14. الآن بيانات تعريف Requires-Python تُظهر >=3.5,<3.15، وتُدرج صفحة PyPI المصنفات لـ Python 3.8 حتى 3.14 صراحةً.
AGENTS.md – دمج وكيل الذكاء الاصطناعي وLLM
حزمة groupdocs-conversion على pip الآن تُضمّن ملف AGENTS.md في المسار groupdocs/conversion/AGENTS.md داخل الـ wheel. يمكن للمساعدين البرمجيين الذكيين الذين يفحصون الحزم المثبتة — مثل Claude Code، Cursor، وGitHub Copilot — اكتشاف سطح API، أنماط الاستخدام، مسارات الاستيراد، ونصائح استكشاف الأخطاء دون الحاجة إلى دليل يدوي.
خصائص كائن الصيغة
كائنات الصيغة التي تُرجعها get_possible_conversions() و get_all_possible_conversions() الآن تُظهر خصائص قابلة للقراءة البشرية:
.extension– مثال:'pdf'.file_format– مثال:'Portable Document Format'.description– مثال:'Portable Document Format File (pdf)'
سابقًا كانت هذه الكائنات تُظهر كـ <NetObject handle=NNN> غير واضحة؛ الآن تُعرض كـ <NetObject pdf> في repr() وتوفر قيمًا نصية نظيفة عبر الخصائص المذكورة أعلاه.
مثال على الشيفرة
import os
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions
output_dir = "./converted-pages"
os.makedirs(output_dir, exist_ok=True)
with Converter("./presentation.pptx") as converter:
options = ImageConvertOptions()
options.format = ImageFileType.PNG
converter.convert_by_page(output_dir, options)
# ينتج: page_1.png, page_2.png, ...
كيفية الحصول على التحديث
PyPI
pip install --upgrade groupdocs-conversion