Ми раді оголосити про випуск 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.Colorgroupdocs.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 для вашої платформи за адресою:
- GroupDocs.Redaction for Python через .NET 26.11 – Windows
- GroupDocs.Redaction for Python через .NET 26.11 – Linux
- GroupDocs.Redaction for Python через .NET 26.11 – macOS Intel
- GroupDocs.Redaction for Python через .NET 26.11 – macOS Apple Silicon