GroupDocs.Signature for Python 26.10 – Основные моменты выпуска октября 2026 года

Мы рады объявить о выпуске GroupDocs.Signature for Python v26.10, доступного с октября 2026 года. Этот крупный релиз обновляет движок GroupDocs.Signature с версии 25.12 до 26.9 и переносит встроенную среду выполнения .NET с .NET Core 3.1 на .NET 10.0.12. В нём добавлены Python‑стиль обратных вызовов для потоков предварительного просмотра, логгера, шифрования данных и поддержки пользовательского хеша подписи, реализована полная совместимость с Python 3.14 и устранены критические проблемы импорта в Linux. В выпуске представлено два основных нововведения, пять улучшений и два исправления ошибок.

Что нового в этом выпуске

• [Feature] Принимать функции Python в качестве обратных вызовов предварительного просмотра страниц и подписей (SIGNATUREPYTHON-21)
• [Feature] Принимать объекты Python в качестве реализаций ILogger, IDataEncryption и ICustomSignHash (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] Генерировать GroupDocsSignatureException, IncorrectPasswordException и PasswordRequiredException вместо RuntimeError (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‑битный wheel для Windows (SIGNATUREPYTHON-30)
• [Fix] Колесо Linux нельзя было импортировать в текущих дистрибутивах (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.

Переименовано

Новые возможности

Генерация превью с помощью 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 можно назначить options.data_encryption у QR‑code или metadata‑подписей. Пользовательский хеш‑подписант может быть функцией или объектом с методом 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

Колесо теперь объявляет python_requires=">=3.5,<3.15" и один wheel на платформу покрывает версии Python 3.5 – 3.14. Изменения кода не требуются; импорт и использование работают в новом интерпретаторе.

Пример кода

См. раздел «Новые возможности» выше для работающих примеров кода, демонстрирующих Python‑обратные вызовы при генерации превью и реализации пользовательского логгера/шифрования.

Как получить обновление

PyPI

Обновите пакет GroupDocs.Signature for Python до последней версии через PyPI: groupdocs-signature-net 26.10.0

Установите с помощью:

pip install groupdocs-signature-net==26.10.0

Прямое скачивание

Скачайте wheel‑пакеты напрямую со страницы GroupDocs.Signature for Python v26.10 release page.

Ресурсы

• Full Release Notes
• Documentation
• Free Support Forum