GroupDocs.Conversion برای Python v26.3 هم‌اکنون در دسترس است. این نسخه تبدیل بر‑صفحه، خروجی به‌صورت جریان در حافظه، پشتیبانی از Python 3.14، فایل‌های یکپارچه‌سازی عامل هوش مصنوعی، بهبود متادیتای فرمت و چندین اصلاح دیگر را اضافه می‌کند.

What’s new in this release

کلید دسته‌بندی خلاصه
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 سند را تبدیل کرده و نتیجه را به‌صورت بایت‌های در‑حافظه برمی‌گرداند

روش‌های هنوز در دسترس نیستند – روش‌های زیر به‌عنوان پراکسی‌های ویژگی در کلاس Converter موجود هستند اما هنوز عملیاتی نیستند. فراخوانی آن‌ها استثنایی ایجاد می‌کند:

روش وضعیت راه‌حل موقت
convert_by_page(file_path, page_number, convert_options) TypeError — بارگذاری ۳‑آرگی در دسترس نیست از convert_options.page_number + convert_options.pages_count = 1 همراه با convert(file_path, options) استفاده کنید
convert_by_page(stream, page_number, convert_options) TypeError — بارگذاری ۳‑آرگی در دسترس نیست ابتدا به‌صورت فایل تبدیل کنید، سپس به 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 3.14
دامنهٔ نسخه‌های پایتون پشتیبانی‌شده از 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
پکیج pip groupdocs-conversion اکنون فایلی به نام 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> مبهم نمایش داده می‌شدند؛ اکنون در repr() به شکل <NetObject pdf> ظاهر می‌شوند و مقادیر رشته‌ای تمیزی از طریق ویژگی‌های فوق در دسترس هستند.

مثال کد

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)
    # produces: page_1.png, page_2.png, ...

نحوه دریافت به‌روزرسانی

PyPI

pip install --upgrade groupdocs-conversion

منابع