Мы рады объявить о выпуске 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.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 для Python через .NET 26.11 – Windows
- GroupDocs.Redaction для Python через .NET 26.11 – Linux
- GroupDocs.Redaction для Python через .NET 26.11 – macOS Intel
- GroupDocs.Redaction для Python через .NET 26.11 – macOS Apple Silicon