We’re happy to announce the release of GroupDocs.Signature for Python v26.10, available as of October 2026. This major release upgrades the underlying GroupDocs.Signature engine from 25.12 to 26.9 and migrates the embedded .NET runtime from .NET Core 3.1 to .NET 10.0.12. It introduces Python‑style callbacks for preview streams, logger, data encryption, and custom sign hash support, adds full compatibility with Python 3.14, and resolves critical import issues on Linux. This release includes two major features, five enhancements, and two bug fixes.

このリリースの新機能

  • [Feature] ページおよび署名プレビューコールバックとして Python 関数を受け入れる (SIGNATUREPYTHON-21)
  • [Feature] ILogger、IDataEncryption、ICustomSignHash 実装として Python オブジェクトを受け入れる (SIGNATUREPYTHON-22)
  • [Feature] Python 3.14 のサポートを追加 (SIGNATUREPYTHON-23)
  • [Enhancement] GroupDocs.Signature エンジンを 25.12 から 26.9 に更新 (SIGNATUREPYTHON-24)
  • [Enhancement] 埋め込み .NET ランタイムを .NET Core 3.1 から .NET 10.0.12 に更新 (SIGNATUREPYTHON-25)
  • [Enhancement] RuntimeError の代わりに GroupDocsSignatureException、IncorrectPasswordException、PasswordRequiredException をスロー (SIGNATUREPYTHON-26)
  • [Enhancement] クラスに存在しない属性を代入したときに AttributeError をスロー (SIGNATUREPYTHON-27)
  • [Enhancement] Python 名が .NET の単語を分割しているメンバーをリネーム (z_order → zorder、x_ad_es_type → xad_es_type) (SIGNATUREPYTHON-28)
  • [Enhancement] リストの内容でオーバーロードを選択し、datetime と Decimal の値を .NET にそのまま渡す (SIGNATUREPYTHON-29)
  • [Enhancement] wheel のプラットフォームタグを manylinux_2_27 と macosx_12_0 に更新し、32 ビット Windows wheel を削除 (SIGNATUREPYTHON-30)
  • [Fix] 現行ディストリビューションで Linux wheel がインポートできない問題を修正 (SIGNATUREPYTHON-31)
  • [Fix] GROUPDOCS_LIC_PATH が無視される問題を修正 (SIGNATUREPYTHON-32)

公開 API の変更

アップグレードする際は、リネームされたメンバー、新しい例外タイプ、更新されたプラットフォームタグに対応する必要があります。属性の代入は現在 AttributeError をスローし、コールバックはプレーンな Python 呼び出し可能オブジェクトで指定できます。

新しいクラスとメンバー

  • groupdocs.signature: ProcessCompleteEventHandler、ProcessProgressEventHandler、ProcessStartEventHandler。
  • groupdocs.signature.domain: OoxmlCompliance。
  • groupdocs.signature.options: CreateSignatureStream、ReleaseSignatureStream、PreviewOptions.CreateDocPageStream、PreviewOptions.ReleaseDocPageStream、PreviewOptions.PreviewFormats、PreviewSignatureOptions.PreviewFormats。
  • ConsoleLogger: error()。
  • DigitalSignOptions: allow_expired、allow_not_yet_valid。
  • DigitalSignature: certificate_store_location、certificate_store_name。
  • FileLogger: error()。
  • ILogger: error()。
  • ImageSignOptions: dispose()。
  • LoadOptions: skip_external_resources、whitelisted_resources。
  • Mailmark2D: class_。
  • MetadataSignatureCollection: append()、get()。
  • PreviewOptions: コンストラクタ(以前はなし)。
  • PreviewSignatureOptions: コンストラクタ(以前はなし)。
  • SearchResult: get_enumerator()、to_list()。
  • Signature: dispose()。
  • SignatureSettings: default_culture。
  • WordProcessingSaveOptions: ooxml_compliance。

リネーム

クラス 旧名 新名
BarcodeTypes DATA_LOGIC_2OF_5 DATA_LOGIC_2OF5
BarcodeTypes GS1_CODE_128 GS1_CODE128
BarcodeTypes GS1_MICRO_PDF_417 GS1_MICRO_PDF417
BarcodeTypes IATA2OF_5 IATA2OF5
BarcodeTypes INTERLEAVED_2OF_5 INTERLEAVED_2OF5
BarcodeTypes MATRIX_2OF_5 MATRIX_2OF5
BarcodeTypes STANDARD_2OF_5 STANDARD_2OF5
BarcodeTypes UPCA_GS_1_CODE_128_COUPON UPCA_GS1_CODE_128_COUPON
BarcodeTypes UPCA_GS_1_DATABAR_COUPON UPCA_GS1_DATABAR_COUPON
DigitalSignature x_ad_es_type xad_es_type
FileType G_ZIP GZIP
FileType L_ZIP LZIP
XAdESType X_AD_ES XAD_ES
DigitalSignOptions x_ad_es_type xad_es_type
JpegCompressionColorMode Y_CB_CR YCB_CR
SignOptions z_order zorder
PdfTextAnnotationAppearance h_corner_radius hcorner_radius
PdfTextAnnotationAppearance v_corner_radius vcorner_radius

新機能

Python コールバックによるプレビュー生成

PreviewOptions はプレーンな Python 関数で構築できるようになりました。create コールバックは page_data オブジェクトを受け取り、書き込み可能なストリーム(ファイルオブジェクトまたは io.BytesIO)を返す必要があります。release コールバックは画像の書き込みが完了した後に呼び出され、同じ page_data とストリームを受け取ります。

from groupdocs.signature import Signature
from groupdocs.signature.options import PreviewOptions

def create_page_stream(page_data):
    return open(f"page-{page_data.page_number}.png", "wb")

def release_page_stream(page_data, page_stream):
    page_stream.close()

with Signature("document.pdf") as signature:
    signature.generate_preview(PreviewOptions(create_page_stream, release_page_stream))

ロガー、暗号化、カスタムハッシュコールバックとしての Python オブジェクト

プレーンな Python オブジェクトが ILogger、IDataEncryption、ICustomSignHash インターフェイスを実装できるようになりました。trace、warning、error メソッドを持つロガーオブジェクトは SignatureSettings に渡せます。encode と decode メソッドを持つ暗号化オブジェクトは QR コードやメタデータ署名の options.data_encryption に設定できます。カスタムハッシュ署名は関数または custom_sign_hash メソッドを持つオブジェクトで、DigitalSignOptions.custom_sign_hash で使用されます。

import base64

from groupdocs.signature import Signature, SignatureSettings
from groupdocs.signature.options import QrCodeSignOptions


class SimpleLogger:
    def trace(self, message):
        print("TRACE:", message)

    def warning(self, message):
        print("WARN:", message)

    def error(self, message, exception=None):
        print("ERROR:", message, exception)


class Base64Encryption:
    def encode(self, source):
        return base64.b64encode(source.encode()).decode()

    def decode(self, source):
        return base64.b64decode(source).decode()


options = QrCodeSignOptions("Private text")
options.data_encryption = Base64Encryption()

with Signature("document.pdf", SignatureSettings(logger=SimpleLogger())) as signature:
    signature.sign("signed.pdf", options)

Python 3.14 のサポート

wheel は python_requires=">=3.5,<3.15" を宣言し、プラットフォームごとに 1 つの wheel が Python 3.5 から 3.14 までをカバーします。コードの変更は不要で、同じインポートと使用方法が新しいインタプリタでも動作します。

コード例

上記「新機能」セクションにある、プレビュー生成やカスタムロガー/暗号化実装の動作例をご参照ください。

更新の取得方法

PyPI

PyPI から最新の GroupDocs.Signature for Python パッケージへアップグレードします: groupdocs-signature-net 26.10.0

インストールコマンド:

pip install groupdocs-signature-net==26.10.0

直接ダウンロード

GroupDocs.Signature for Python v26.10 リリースページ から wheel パッケージを直接ダウンロードできます。

リソース