Ми раді оголосити про випуск 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 та вбудований runtime до .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] Колеса встановлюються на 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 для вашої платформи за адресою:

Ресурси