GroupDocs.Conversion for Python v26.3 זמין כעת. גרסה זו מוסיפה המרה לפי דף, פלט בזיכרון, תמיכה ב‑Python 3.14, קבצי אינטגרציה של סוכן AI, מטא‑נתוני פורמט משופרים, וכמה שיפורים.

What’s new in this release

Key Category Summary
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 בתוך החבילה לאינטגרציית סוכן AI
CONVERSIONPYTHON-67 שיפור אובייקטי פורמט חושפים את המאפיינים .extension, .file_format, .description
CONVERSIONPYTHON-68 שיפור הוספת מסווג macOS מפורש במטא‑נתוני PyPI

Public API changes

שיטות פונקציונליות חדשות – שיטות אלו הוגדרו ב‑25.12 אך העלו NotImplementedError. הן פעילות כעת:

Method Returns Description
Converter.convert_by_page(output_dir, convert_options) None מחלקת מסמך לקובץ נפרד לכל דף בתיקייה שנקבעה
Converter.convert_to_stream(convert_options) bytes ממירה את המסמך ומחזירה את התוצאה כ‑bytes בזיכרון

שיטות שעדיין אינן זמינות – השיטות הבאות קיימות כפרוקסי של תכונות במחלקת Converter אך אינן פעילות בממשק Python. קריאה אליהן תגרום לחריגה:

Method Status Workaround
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) לקבלת פלט קובץ יחיד מאוחסן בארכיונים

New features

המרה לפי דף – 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 – אינטגרציית סוכן AI ו‑LLM
חבילת groupdocs-conversion ב‑pip כוללת כעת קובץ AGENTS.md ב‑groupdocs/conversion/AGENTS.md בתוך ה‑wheel. עוזרי קוד AI הסורקים חבילות מותקנות — כגון Claude Code, Cursor, ו‑GitHub Copilot — יכולים לגלות אוטומטית את ממשק ה‑API, דפוסי השימוש, נתיבי ה‑import, וטיפים לפתרון בעיות ללא צורך במדריך ידני.

מאפייני אובייקט פורמט
אובייקטי פורמט המוחזרים על‑ידי 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() ומספקים ערכי מחרוזת נקיים דרך המאפיינים המצוינים למעלה.

Code example

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, ...

How to get the update

PyPI

pip install --upgrade groupdocs-conversion

Resources