We’re happy to announce the release of GroupDocs.Redaction for Python v26.11, available as of November 2026. This release upgrades the GroupDocs.Redaction engine from 26.5 to 26.10 and embeds .NET runtime 10.0.15, replacing System.Drawing with Aspose.Drawing and SkiaSharp for cross-platform rasterization and image-area redaction—including Linux and macOS. New features include page previews, Python logger support, Python OCR connector integration, OOXML compliance control for Word documents, explicit file type loading, and license status checking.
What’s new in this release
- [Feature] Add support for page previews to files and
io.BytesIO(PreviewOptions,generate_preview()) (REDACTIONPYTHONNET-23) - [Feature] Add support for a Python logger (
ILogger) (REDACTIONPYTHONNET-24) - [Feature] Add support for a Python OCR connector (
IOcrConnector) to redact text in images (REDACTIONPYTHONNET-25) - [Feature] Add support for setting the OOXML compliance level of a saved Word document (
ooxml_compliance) (REDACTIONPYTHONNET-26) - [Feature] Add support for opening a document as a given file type (
LoadOptions.file_type) (REDACTIONPYTHONNET-27) - [Feature] Add support for checking whether a license is applied (
License.is_licensed) (REDACTIONPYTHONNET-28) - [Enhancement] Update GroupDocs.Redaction to 26.10 and the embedded runtime to .NET 10.0.15 (REDACTIONPYTHONNET-29)
- [Enhancement] Replace
groupdocs.pydrawingtypes withgroupdocs.redaction.options.drawing(Color,Point,Size,Rectangle,Font,FontStyle) (REDACTIONPYTHONNET-30) - [Enhancement] Return
RedactionTypeandRedactionActionTypeenums from a redaction callback’s description (REDACTIONPYTHONNET-31) - [Enhancement] Raise
AttributeErrorwhen an unknown attribute is assigned to an API object (REDACTIONPYTHONNET-32) - [Enhancement] Raise
LicenseErrorfor a license that cannot be applied, and export it andGroupDocsRedactionExceptionfromgroupdocs.redaction(REDACTIONPYTHONNET-33) - [Enhancement] Install
groupdocs.pydrawingandgroupdocs.pycorefrom the sharedgroupdocs-shared-netpackage (REDACTIONPYTHONNET-34) - [Fix] Fix CVE findings in 26.6.0: .NET runtime 10.0.0 → 10.0.15 (+2 more) (REDACTIONPYTHONNET-12)
- [Fix] Rasterized PDF output and image-area redaction raise
PlatformNotSupportedExceptionon Linux and macOS (REDACTIONPYTHONNET-35) - [Fix] A redaction callback fails with
JSONDecodeErroron text that contains a tab (REDACTIONPYTHONNET-36) - [Fix]
RedactorSettingsraisesTypeErrorfor a redaction callback passed as its only argument (REDACTIONPYTHONNET-37) - [Fix] Wheels install on Linux and macOS versions the embedded .NET runtime cannot run on (REDACTIONPYTHONNET-38)
Public API changes
Upgraders need to import colors and geometry from groupdocs.redaction.options.drawing, and to compare a redaction callback’s redaction_type and action_type with enum members. Everything else is additive.
New classes and members
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 is a new module. GroupDocsRedactionException is still exported by groupdocs.redaction.exceptions too.
Removed
The groupdocs.pydrawing color that 26.6 re-exported; import Color from groupdocs.redaction.options.drawing instead:
groupdocs.redaction.Colorgroupdocs.redaction.redactions.Color
Changed
- Every member that takes or returns a color, point, size or rectangle uses the
groupdocs.redaction.options.drawingtypes. Agroupdocs.pydrawingvalue raisesTypeError(no overload matched). RedactionDescription.redaction_typeandaction_type, which a redaction callback reads, areRedactionTypeandRedactionActionTypemembers.- The engine’s obsolete aliases are present too:
ReplacementOptions.box_fill_color,RegionReplacementOptions.area_fill_colorandarea_size,ImageAreaRedaction.top_left_position,PageAreaFilter.area_rectangleandTextFragment.bounding_rectangle. Usebox_color,fill_color,size,top_leftandrectangle.
New features
Page previews
Redactor.generate_preview() renders document pages to images. PreviewOptions takes a function that returns a stream for each page, an open binary file or an io.BytesIO, and optionally a second function that releases each page’s stream. Set width, height and page_numbers. 26.6.0 refused a Python function there with TypeError.
Python logger
RedactorSettings(logger=...) takes an object with error(message), warning(message) and trace(message), and the engine reports through it. 26.6.0 refused a Python logger with TypeError.
Python OCR connector
GroupDocs.Redaction ships no OCR engine. RedactorSettings(ocr_connector=...) takes an object with recognize(image_stream) that returns what your OCR engine found: a RecognizedImage of TextLines of TextFragments, each with its text and rectangle. The engine then finds the phrases in the image and paints over them. Report each line of text as one TextFragment. 26.6.0 refused a Python connector with TypeError.
OOXML compliance level of a saved Word document
SaveOptions.wordprocessing_save_options.ooxml_compliance sets the OOXML compliance level of a saved Word document: WordProcessingComplianceLevel.ECMA, TRANSITIONAL or STRICT. Unset, the document keeps the level it had. 26.6.0 did not have it.
Open a document as a given file type
LoadOptions(file_type) opens a stream, or a file whose name does not say its format, as the given FileType. 26.6.0 did not have it.
Check whether a license is applied
License().is_licensed is True once a license is applied, with License().set_license() or from the GROUPDOCS_LIC_PATH environment variable.
Code example
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")
How to get the update
PyPI
Upgrade via PyPI:
Install with:
pip install groupdocs-redaction-net==26.11.0
Direct download
Download the wheel for your platform from:
- GroupDocs.Redaction for Python via .NET 26.11 – Windows
- GroupDocs.Redaction for Python via .NET 26.11 – Linux
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Intel
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Apple Silicon