We’re happy to announce the release of GroupDocs.Conversion for Python v26.9, available as of September 2026. This release upgrades the underlying GroupDocs.Conversion engine from 26.3 to 26.8, introduces the ConversionEvents API for real‑time conversion monitoring, adds support for XAR archives, draw.io, and Mermaid diagrams, and includes several new load and convert options. It also resolves critical compatibility issues on Python 3.5–3.10 and fixes longstanding defects affecting delegate‑typed properties and enum arguments.
What’s new in this release
- [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] Python 3.8‑3.10 で Enum 引数を渡すとランタイムエラーが発生する問題を修正 (CONVERSIONPYTHON-92)
- [Fix]
*DocumentInfoとPossibleConversionsのインデクサitemがプロパティで呼び出せない問題を修正 (CONVERSIONPYTHON-105) - [Fix] デリゲート型プロパティに Python から代入できない問題(
Object must implement IConvertible)を修正 (CONVERSIONPYTHON-106) - [Fix] デリゲート型プロパティがスタブと docstring で誤った型で注釈付けされている問題を修正 (CONVERSIONPYTHON-107)
パブリック API の変更
新しいクラス
| クラス | モジュール |
|---|---|
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を受け取る 4 つの新しいコンストラクタオーバーロードを追加CadLoadOptions.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 にそのまま残っています。
インポート元を変更するだけで、他に変更は不要です:
# 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 です。
新フォーマット
| フォーマット | ファイルタイプ定数 | 備考 |
|---|---|---|
| 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 ページからダウンロードしてください。