我们很高兴宣布 GroupDocs.Redaction for Python v26.11 已于 2026年11月 发布。此版本将 GroupDocs.Redaction 引擎从 26.5 升级至 26.10,并嵌入 .NET 运行时 10.0.15,使用 Aspose.Drawing 和 SkiaSharp 替代 System.Drawing,实现跨平台光栅化和图像区域脱敏——包括 Linux 和 macOS。新功能包括页面预览、Python 日志记录支持、Python OCR 连接器集成、Word 文档的 OOXML 合规性控制、显式文件类型加载以及许可证状态检查。
本次发布的新功能
- [Feature] 添加对文件和
io.BytesIO的页面预览支持(PreviewOptions、generate_preview()) (REDACTIONPYTHONNET-23) - [Feature] 添加对 Python 日志记录器(
ILogger)的支持 (REDACTIONPYTHONNET-24) - [Feature] 添加对 Python OCR 连接器(
IOcrConnector)的支持,以对图像中的文本进行脱敏 (REDACTIONPYTHONNET-25) - [Feature] 添加对设置已保存 Word 文档的 OOXML 合规级别(
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] 当向 API 对象分配未知属性时抛出
AttributeError(REDACTIONPYTHONNET-32) - [Enhancement] 对无法应用的许可证抛出
LicenseError,并从groupdocs.redaction导出该异常及GroupDocsRedactionException(REDACTIONPYTHONNET-33) - [Enhancement] 从共享的
groupdocs-shared-net包中安装groupdocs.pydrawing和groupdocs.pycore(REDACTIONPYTHONNET-34) - [Fix] 修复 26.6.0 中的 CVE 问题:.NET 运行时 10.0.0 → 10.0.15(另加 2 项) (REDACTIONPYTHONNET-12)
- [Fix] 在 Linux 和 macOS 上,光栅化的 PDF 输出和图像区域脱敏会抛出
PlatformNotSupportedException(REDACTIONPYTHONNET-35) - [Fix] 当文本包含制表符时,脱敏回调会因
JSONDecodeError失败 (REDACTIONPYTHONNET-36) - [Fix]
RedactorSettings在将脱敏回调作为唯一参数传入时抛出TypeError(REDACTIONPYTHONNET-37) - [Fix] 在 Linux 和 macOS 上,Wheels 安装的嵌入式 .NET 运行时版本无法运行 (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 中被重新导出;请改为从 groupdocs.redaction.options.drawing 导入 Color:
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 引擎识别的内容:包含 TextLine 的 RecognizedImage,每个 TextLine 包含 TextFragment,并带有文本和矩形。引擎随后在图像中查找这些短语并进行遮盖。将每行文本报告为一个 TextFragment。在 26.6.0 中,该 Python 连接器会因 TypeError 被拒绝。
已保存 Word 文档的 OOXML 合规级别
SaveOptions.wordprocessing_save_options.ooxml_compliance 设置已保存 Word 文档的 OOXML 合规级别:WordProcessingComplianceLevel.ECMA、TRANSITIONAL 或 STRICT。如果未设置,文档保持原有级别。26.6.0 中没有此功能。
以指定文件类型打开文档
LoadOptions(file_type) 将流或文件(其名称未指明格式)以给定的 FileType 打开。26.6.0 中没有此功能。
检查许可证是否已应用
一旦通过 License().set_license() 或 GROUPDOCS_LIC_PATH 环境变量应用了许可证,License().is_licensed 将返回 True。
代码示例
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