GroupDocs.Conversion for Python v26.3 が利用可能になりました。このリリースでは、ページ単位の変換、メモリ内ストリーム出力、Python 3.14 のサポート、AI エージェント統合用ファイル、拡張されたフォーマットメタデータ、そしていくつかの改良が追加されています。

このリリースの新機能

キー カテゴリ 概要
CONVERSIONPYTHON-65 Feature convert_by_page(output_dir, convert_options) によるページ単位の変換
CONVERSIONPYTHON-66 Feature convert_to_stream(convert_options) によるメモリ内変換
CONVERSIONPYTHON-62 Feature Python 3.14 のサポート
CONVERSIONPYTHON-64 Feature AI エージェント統合のためにパッケージ内に AGENTS.md を同梱
CONVERSIONPYTHON-67 Enhancement フォーマットオブジェクトが .extension, .file_format, .description プロパティを公開
CONVERSIONPYTHON-68 Enhancement PyPI メタデータに macOS 用の明示的な classifier を追加

公開 API の変更

新しい機能メソッド – これらのメソッドは 25.12 で宣言されていましたが NotImplementedError が発生していました。現在は動作します。

メソッド 戻り値 説明
Converter.convert_by_page(output_dir, convert_options) None 指定ディレクトリにページごとに 1 ファイルずつ分割して保存
Converter.convert_to_stream(convert_options) bytes ドキュメントを変換し、メモリ内のバイト列として返す

まだ利用できないメソッド – 以下のメソッドは Converter クラスの属性プロキシとして存在しますが、Python バインディングでは まだ機能していません。呼び出すと例外が発生します。

メソッド 状態 回避策
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) を使用

新機能

ページ単位の変換 – convert_by_page
Converter.convert_by_page(output_dir, convert_options) メソッドが完全に機能するようになりました。マルチページドキュメントをページごとの個別ファイルに分割し、指定ディレクトリに保存します。ページファイルは page_1.ext, page_2.ext のように命名されます。このメソッドは ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions など、ページベースの出力をサポートするすべての ConvertOptions クラスで利用可能です。

メモリ内変換 – convert_to_stream
Converter.convert_to_stream(convert_options) メソッドは、変換されたドキュメントを Python の bytes オブジェクトとして返すようになりました。これにより、ディスクへの書き込みなしでメモリ内変換パイプラインを構築できます。クラウド関数、Web アプリケーション、ストリーミングアーキテクチャなど、ファイルシステムへのアクセスが制限または望ましくない環境で有用です。

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 までの classifier が明示的に記載されています。

AGENTS.md – AI エージェントおよび LLM 統合
groupdocs-conversion pip パッケージは、wheel 内の groupdocs/conversion/AGENTS.md に AGENTS.md ファイルを同梱します。Claude Code、Cursor、GitHub Copilot などの AI コーディングアシスタントは、インストール済みパッケージをスキャンして API の概要、使用パターン、インポートパス、トラブルシューティングのヒントを自動的に検出できるようになります。

フォーマットオブジェクトのプロパティ
get_possible_conversions() および get_all_possible_conversions() が返すフォーマットオブジェクトは、以下の人間が読みやすいプロパティを公開します。

  • .extension – 例: 'pdf'
  • .file_format – 例: 'Portable Document Format'
  • .description – 例: 'Portable Document Format File (pdf)'

従来は <NetObject handle=NNN> のような不透明な表現でしたが、repr() では <NetObject pdf> と表示され、上記プロパティでクリーンな文字列値を取得できます。

コード例

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)
    # 生成物: page_1.png, page_2.png, ...

アップデートの取得方法

PyPI

pip install --upgrade groupdocs-conversion

リソース