אנחנו שמחים להודיע על השחרור של GroupDocs.Conversion for Python v26.9, זמין החל מ-ספטמבר 2026. שחרור זה משדרג את מנוע GroupDocs.Conversion הבסיסי מ‑26.3 ל‑26.8, מציג את ממשק ה‑ConversionEvents למעקב בזמן אמת על המרות, מוסיף תמיכה בארכיוני XAR, ב‑draw.io וב‑Mermaid, ומכיל מספר אפשרויות טעינה והמרה חדשות. בנוסף, הוא פותר בעיות תאימות קריטיות ב‑Python 3.5–3.10 ומתקן פגמים ישנים המשפיעים על תכונות מסוג delegate וארגומנטים של Enum.

מה חדש בגרסה זו

  • [Feature] הוספת תמיכה ב‑ConversionEvents לצפייה בתחילת ההמרה, התקדמות, השלמה של כל עמוד וכל מסמך, תקלות והחלפת גופנים (CONVERSIONPYTHON-93)
  • [Feature] הוספת תמיכה בפורמטים חדשים — ארכיוני XAR, דיאגרמות draw.io ודיאגרמות Mermaid (.mmd) (CONVERSIONPYTHON-94)
  • [Feature] הוספת CadLoadOptions.layout_scope להגבלת המרת CAD למרחב מודל, פריסות נייר או לשניהם (CONVERSIONPYTHON-95)
  • [Feature] הוספת MarkdownOptions.image_saving_callback לשליטה במיקום שבו נכתבות התמונות המופקות ל‑Markdown (CONVERSIONPYTHON-96)
  • [Feature] הוספת EmailLoadOptions.page_layout_options ו‑WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
  • [Feature] הוספת ImageConvertOptions.min_resolution ו‑cap_resolution_to_page_content (CONVERSIONPYTHON-98)
  • [Feature] הוספת WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
  • [Feature] הוספת MissingDependencyException למתן הודעת כשל ברורה יותר כאשר תלות מנוע אופציונלית חסרה (CONVERSIONPYTHON-100)
  • [Enhancement] עדכון מנוע GroupDocs.Conversion מ‑26.3 ל‑26.8 (CONVERSIONPYTHON-101)
  • [Enhancement] הסרת המודול המשוכפל groupdocs.conversion.file_types — השתמשו ב‑groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
  • [Enhancement] שינוי שם PdfOptions.remove_pdf_acompliance ל‑remove_pdf_a_compliance (CONVERSIONPYTHON-103)
  • [Enhancement] הוספת סעיף מדריך למפתחים ודפים groupdocs.conversion.integration.* לתיעוד ה‑API (CONVERSIONPYTHON-104)
  • [Fix] אי‑אפשרות לייבא מודול ב‑Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
  • [Fix] שגיאת זמן ריצה בעת העברת ארגומנט Enum בגרסאות Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
  • [Fix] המאפיין item ב‑*DocumentInfo וב‑PossibleConversions הוא property ולא ניתן לקריאה (CONVERSIONPYTHON-105)
  • [Fix] לא ניתן להקצות ערכים לתכונות מסוג delegate מ‑Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
  • [Fix] תכונות מסוג delegate מתועדות עם סוג שגוי בקבצי stub וב‑docstrings (CONVERSIONPYTHON-107)

שינויי API ציבוריים

מחלקות חדשות

Class Module
ConversionEvents groupdocs.conversion
FontSubstitutionContext groupdocs.conversion.contracts
XarDocumentInfo groupdocs.conversion.contracts
MissingDependencyException groupdocs.conversion.exceptions
CadLayoutScope groupdocs.conversion.options.load
IPageLayoutOptions groupdocs.conversion.options.load
MarkdownImageSavingArgs, IMarkdownImageSavingCallback groupdocs.conversion.options.convert
IConversionHandlersStage, IConversionByPageHandlersStage groupdocs.conversion.fluent

חברים חדשים במחלקות קיימות

  • FluentConverter.with_events(...), וכן באותו אופן ב‑IConversionFrom וב‑IConversionSettings
  • Converter(...) — ארבעה קונסטרוקטורים חדשים המקבלים ConversionEvents
  • CadLoadOptions.layout_scope
  • EmailLoadOptions.page_layout_options
  • WebLoadOptions.margin_settings, .orientation_settings, .size_settings
  • MarkdownOptions.image_saving_callback
  • ImageConvertOptions.min_resolution, .cap_resolution_to_page_content
  • WordProcessingLoadOptions.auto_detect_rtl_direction
  • CompressionFileType.XAR, DiagramFileType.DRAWIO, DiagramFileType.MMD

הוסר — groupdocs.conversion.file_types

המודול groupdocs.conversion.file_types וה‑23 מחלקות שלו הוסרו. המחלקות עצמן אינן מוסרות — כל אחת מהן עדיין קיימת, ללא שינוי, ב‑groupdocs.conversion.filetypes.

אם ייבאתם ממנו, החליפו את ה‑import — ולא יותר:

# before
from groupdocs.conversion.file_types import WordProcessingFileType
# after
from groupdocs.conversion.filetypes import WordProcessingFileType

שונה שם — PdfOptions.remove_pdf_acompliance

# before
options.remove_pdf_acompliance = True
# after
options.remove_pdf_a_compliance = True

תכונות חדשות

אירועי המרה

ConversionEvents מאפשר לצפות במהלך ההמרה בזמן שהיא מתבצעת — התקדמות, השלמה של כל עמוד וכל מסמך, תקלות והחלפת גופנים. ניתן לצרף פונקציות Python רגילות:

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

שימו לב שהקונסטרוקטור מקבל (path, settings, events) — אין עומס (path, events), ולכן יש להעביר ConverterSettings() גם כאשר אין צורך להגדיר משהו.

המתודות הזמינות הן on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed ו‑on_font_substituted.

פורמטים חדשים

Format File type constant Notes
ארכיון XAR CompressionFileType.XAR כולל גם XarDocumentInfo לבחינה
דיאגרמת draw.io DiagramFileType.DRAWIO
דיאגרמת Mermaid DiagramFileType.MMD

תחום פריסת CAD

from groupdocs.conversion.options.load import CadLayoutScope, CadLoadOptions

load_options = CadLoadOptions()
load_options.layout_scope = CadLayoutScope.MODEL     # MODEL | LAYOUTS | BOTH

BOTH הוא ברירת המחדל ואינו מגביל את ההמרה.

דוגמת קוד

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

איך לקבל את העדכון

PyPI

pip install groupdocs-conversion-net==26.9.0

הורדה ישירה

הורדה מהדף GroupDocs.Conversion for Python via .NET 26.9.

משאבים