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 パッケージを直接ダウンロードできます。