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_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 にそのまま残っています。

インポート元を変更するだけで、他に変更は不要です:

# 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 ページからダウンロードしてください。

リソース