Мы рады объявить о выпуске GroupDocs.Redaction for Python v26.11, доступном с ноября 2026. Этот выпуск обновляет движок GroupDocs.Redaction с версии 26.5 до 26.10 и встраивает .NET runtime 10.0.15, заменяя System.Drawing на Aspose.Drawing и SkiaSharp для кроссплатформенной растеризации и редактирования областей изображений — включая Linux и macOS. Новые возможности включают предварительный просмотр страниц, поддержку Python‑логгера, интеграцию Python‑OCR‑коннектора, контроль соответствия OOXML для документов Word, явную загрузку типа файла и проверку статуса лицензии.

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

  • [Feature] Добавлена поддержка предварительного просмотра страниц для файлов и io.BytesIO (PreviewOptions, generate_preview()) (REDACTIONPYTHONNET-23)
  • [Feature] Добавлена поддержка Python‑логгера (ILogger) (REDACTIONPYTHONNET-24)
  • [Feature] Добавлена поддержка Python‑OCR‑коннектора (IOcrConnector) для редактирования текста на изображениях (REDACTIONPYTHONNET-25)
  • [Feature] Добавлена поддержка установки уровня соответствия OOXML сохранённого документа Word (ooxml_compliance) (REDACTIONPYTHONNET-26)
  • [Feature] Добавлена поддержка открытия документа как указанного типа файла (LoadOptions.file_type) (REDACTIONPYTHONNET-27)
  • [Feature] Добавлена поддержка проверки, применена ли лицензия (License.is_licensed) (REDACTIONPYTHONNET-28)
  • [Enhancement] Обновление GroupDocs.Redaction до версии 26.10 и встроенного рантайма до .NET 10.0.15 (REDACTIONPYTHONNET-29)
  • [Enhancement] Замена типов groupdocs.pydrawing на groupdocs.redaction.options.drawing (Color, Point, Size, Rectangle, Font, FontStyle) (REDACTIONPYTHONNET-30)
  • [Enhancement] Возврат перечислений RedactionType и RedactionActionType из описания колбэка редактирования (REDACTIONPYTHONNET-31)
  • [Enhancement] Выбрасывание AttributeError, когда неизвестный атрибут присваивается объекту API (REDACTIONPYTHONNET-32)
  • [Enhancement] Выбрасывание LicenseError для лицензии, которую нельзя применить, и экспорт этого исключения и GroupDocsRedactionException из groupdocs.redaction (REDACTIONPYTHONNET-33)
  • [Enhancement] Установка groupdocs.pydrawing и groupdocs.pycore из общего пакета groupdocs-shared-net (REDACTIONPYTHONNET-34)
  • [Fix] Исправление уязвимостей CVE в версии 26.6.0: .NET runtime 10.0.0 → 10.0.15 (+2 дополнительных) (REDACTIONPYTHONNET-12)
  • [Fix] Растрированный вывод PDF и редактирование областей изображения вызывают PlatformNotSupportedException в Linux и macOS (REDACTIONPYTHONNET-35)
  • [Fix] Колбэк редактирования падает с JSONDecodeError при тексте, содержащем табуляцию (REDACTIONPYTHONNET-36)
  • [Fix] RedactorSettings вызывает TypeError при передаче колбэка редактирования в качестве единственного аргумента (REDACTIONPYTHONNET-37)
  • [Fix] Wheels устанавливаются на Linux и macOS версии, на которых встроенный .NET runtime не может работать (REDACTIONPYTHONNET-38)

Изменения публичного API

При обновлении необходимо импортировать цвета и геометрию из groupdocs.redaction.options.drawing, а также сравнивать redaction_type и action_type колбэка редактирования с членами перечислений. Всё остальное добавляется.

Новые классы и члены

  • groupdocs.redaction: CancellationToken, CancellationTokenSource, OperationCanceledError, LicenseError, LicenseWarning, GroupDocsRedactionException.
  • groupdocs.redaction.options: WordProcessingComplianceLevel, WordprocessingSaveOptions.
  • groupdocs.redaction.options.drawing: Color, Font, FontStyle, Point, Rectangle, Size.
  • FileType: DJVU, LOG, OTP, POTM, POTX, PPS, PPSM, PPSX, PPTM, TAB, WEBP, XLT, XLTM, XLTX.
  • License: is_licensed.
  • LoadOptions: file_type.
  • SaveOptions: wordprocessing_save_options.

groupdocs.redaction.options.drawing — новый модуль. GroupDocsRedactionException также экспортируется из groupdocs.redaction.exceptions.

Удалено

groupdocs.pydrawing цвет, переэкспортированный в 26.6; импортируйте Color из groupdocs.redaction.options.drawing вместо этого:

  • groupdocs.redaction.Color
  • groupdocs.redaction.redactions.Color

Изменено

  • Каждый член, принимающий или возвращающий цвет, точку, размер или прямоугольник, использует типы groupdocs.redaction.options.drawing. Значение groupdocs.pydrawing вызывает TypeError (нет подходящей перегрузки).
  • RedactionDescription.redaction_type и action_type, которые читает колбэк редактирования, являются членами RedactionType и RedactionActionType.
  • Устаревшие псевдонимы движка также присутствуют: ReplacementOptions.box_fill_color, RegionReplacementOptions.area_fill_color и area_size, ImageAreaRedaction.top_left_position, PageAreaFilter.area_rectangle и TextFragment.bounding_rectangle. Используйте box_color, fill_color, size, top_left и rectangle.

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

Предпросмотр страниц

Redactor.generate_preview() рендерит страницы документа в изображения. PreviewOptions принимает функцию, возвращающую поток для каждой страницы, открытый бинарный файл или io.BytesIO, а также опционально вторую функцию, освобождающую поток каждой страницы. Установите width, height и page_numbers. В версии 26.6.0 функция Python отклонялась с TypeError.

Python‑логгер

RedactorSettings(logger=...) принимает объект с методами error(message), warning(message) и trace(message), через который движок отправляет отчёты. В версии 26.6.0 Python‑логгер отклонялся с TypeError.

Python‑OCR‑коннектор

GroupDocs.Redaction не поставляется с OCR‑движком. RedactorSettings(ocr_connector=...) принимает объект с методом recognize(image_stream), который возвращает результат работы вашего OCR‑движка: RecognizedImage с TextLine‑ами, содержащими TextFragment‑ы, каждый со своим текстом и прямоугольником. Затем движок находит фразы на изображении и закрашивает их. Отчитывайтесь о каждой строке текста как о одном TextFragment. В версии 26.6.0 Python‑коннектор отклонялся с TypeError.

Уровень соответствия OOXML сохранённого документа Word

SaveOptions.wordprocessing_save_options.ooxml_compliance задаёт уровень соответствия OOXML сохранённого документа Word: WordProcessingComplianceLevel.ECMA, TRANSITIONAL или STRICT. Если не установлен, документ сохраняет прежний уровень. В версии 26.6.0 этой возможности не было.

Открытие документа как указанного типа файла

LoadOptions(file_type) открывает поток или файл, название которого не указывает формат, как указанный FileType. В версии 26.6.0 этой возможности не было.

Проверка применения лицензии

License().is_licensed возвращает True, как только лицензия применена, с помощью License().set_license() или переменной окружения GROUPDOCS_LIC_PATH.

Пример кода

import io
from groupdocs.redaction import Redactor
from groupdocs.redaction.options import PreviewOptions, PreviewFormats

pages = {}

def create_page_stream(page_number):
    pages[page_number] = io.BytesIO()
    return pages[page_number]

with Redactor("document.pdf") as redactor:
    options = PreviewOptions(create_page_stream)
    options.width, options.height = 300, 400
    options.page_numbers = [1]
    options.preview_format = PreviewFormats.PNG
    redactor.generate_preview(options)

print(len(pages[1].getvalue()), "bytes of PNG")

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

PyPI

Обновление через PyPI:

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

pip install groupdocs-redaction-net==26.11.0

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

Скачайте wheel для вашей платформы по ссылке:

Ресурсы