אנחנו שמחים להודיע על השחרור של 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וב‑IConversionSettingsConverter(...)— ארבעה קונסטרוקטורים חדשים המקבליםConversionEventsCadLoadOptions.layout_scopeEmailLoadOptions.page_layout_optionsWebLoadOptions.margin_settings,.orientation_settings,.size_settingsMarkdownOptions.image_saving_callbackImageConvertOptions.min_resolution,.cap_resolution_to_page_contentWordProcessingLoadOptions.auto_detect_rtl_directionCompressionFileType.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.