Chúng tôi rất vui mừng thông báo việc phát hành GroupDocs.Redaction for Python v26.11, có sẵn từ Tháng 11 năm 2026. Bản phát hành này nâng cấp engine GroupDocs.Redaction từ 26.5 lên 26.10 và nhúng runtime .NET 10.0.15, thay thế System.Drawing bằng Aspose.Drawing và SkiaSharp để thực hiện rasterization đa nền tảng và việc che khuất vùng ảnh—bao gồm Linux và macOS. Các tính năng mới bao gồm xem trước trang, hỗ trợ logger Python, tích hợp kết nối OCR Python, kiểm soát tuân thủ OOXML cho tài liệu Word, tải tệp theo kiểu rõ ràng, và kiểm tra trạng thái giấy phép.

Những gì mới trong bản phát hành này

  • [Tính năng] Thêm hỗ trợ xem trước trang cho các tệp và io.BytesIO (PreviewOptions, generate_preview()) (REDACTIONPYTHONNET-23)
  • [Tính năng] Thêm hỗ trợ cho một logger Python (ILogger) (REDACTIONPYTHONNET-24)
  • [Tính năng] Thêm hỗ trợ cho một kết nối OCR Python (IOcrConnector) để che khuất văn bản trong hình ảnh (REDACTIONPYTHONNET-25)
  • [Tính năng] Thêm hỗ trợ thiết lập mức độ tuân thủ OOXML của tài liệu Word đã lưu (ooxml_compliance) (REDACTIONPYTHONNET-26)
  • [Tính năng] Thêm hỗ trợ mở tài liệu dưới dạng một kiểu tệp nhất định (LoadOptions.file_type) (REDACTIONPYTHONNET-27)
  • [Tính năng] Thêm hỗ trợ kiểm tra xem giấy phép đã được áp dụng chưa (License.is_licensed) (REDACTIONPYTHONNET-28)
  • [Cải tiến] Cập nhật GroupDocs.Redaction lên 26.10 và runtime nhúng lên .NET 10.0.15 (REDACTIONPYTHONNET-29)
  • [Cải tiến] Thay thế các kiểu groupdocs.pydrawing bằng groupdocs.redaction.options.drawing (Color, Point, Size, Rectangle, Font, FontStyle) (REDACTIONPYTHONNET-30)
  • [Cải tiến] Trả về các enum RedactionType và RedactionActionType từ mô tả của callback redaction (REDACTIONPYTHONNET-31)
  • [Cải tiến] Ném AttributeError khi một thuộc tính không xác định được gán cho một đối tượng API (REDACTIONPYTHONNET-32)
  • [Cải tiến] Ném LicenseError cho một giấy phép không thể áp dụng, và xuất nó cùng GroupDocsRedactionException từ groupdocs.redaction (REDACTIONPYTHONNET-33)
  • [Cải tiến] Cài đặt groupdocs.pydrawing và groupdocs.pycore từ gói chia sẻ groupdocs-shared-net (REDACTIONPYTHONNET-34)
  • [Sửa lỗi] Sửa các lỗ hổng CVE trong 26.6.0: runtime .NET 10.0.0 → 10.0.15 (+2 nữa) (REDACTIONPYTHONNET-12)
  • [Sửa lỗi] Kết xuất PDF raster và việc che khuất vùng ảnh gây ra PlatformNotSupportedException trên Linux và macOS (REDACTIONPYTHONNET-35)
  • [Sửa lỗi] Một callback redaction thất bại với JSONDecodeError trên văn bản chứa tab (REDACTIONPYTHONNET-36)
  • [Sửa lỗi] RedactorSettings ném TypeError cho một callback redaction được truyền làm đối số duy nhất (REDACTIONPYTHONNET-37)
  • [Sửa lỗi] Wheels cài đặt trên các phiên bản Linux và macOS mà runtime .NET nhúng không thể chạy được (REDACTIONPYTHONNET-38)

Thay đổi API công cộng

Người nâng cấp cần nhập màu và hình học từ groupdocs.redaction.options.drawing, và so sánh redaction_type và action_type của callback redaction với các thành viên enum. Các phần còn lại đều là bổ sung.

Các lớp và thành viên mới

  • 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 là một mô-đun mới. GroupDocsRedactionException vẫn được xuất ra bởi groupdocs.redaction.exceptions.

Đã loại bỏ

Màu groupdocs.pydrawing mà 26.6 đã tái xuất; thay vào đó nhập Color từ groupdocs.redaction.options.drawing:

  • groupdocs.redaction.Color
  • groupdocs.redaction.redactions.Color

Đã thay đổi

  • Mọi thành viên nhận hoặc trả về màu, điểm, kích thước hoặc hình chữ nhật đều sử dụng các kiểu groupdocs.redaction.options.drawing. Giá trị groupdocs.pydrawing sẽ ném TypeError (không có overload phù hợp).
  • RedactionDescription.redaction_type và action_type, mà một callback redaction đọc, là các thành viên RedactionType và RedactionActionType.
  • Các bí danh lỗi thời của engine cũng vẫn tồn tại: ReplacementOptions.box_fill_color, RegionReplacementOptions.area_fill_color và area_size, ImageAreaRedaction.top_left_position, PageAreaFilter.area_rectangle và TextFragment.bounding_rectangle. Sử dụng box_color, fill_color, size, top_left và rectangle.

Tính năng mới

Xem trước trang

Redactor.generate_preview() tạo ra các trang tài liệu dưới dạng hình ảnh. PreviewOptions nhận một hàm trả về một stream cho mỗi trang, một tệp nhị phân mở hoặc một io.BytesIO, và tùy chọn một hàm thứ hai để giải phóng stream của mỗi trang. Đặt width, height và page_numbers. 26.6.0 đã từ chối một hàm Python ở đó với TypeError.

Logger Python

RedactorSettings(logger=...) nhận một đối tượng có các phương thức error(message), warning(message) và trace(message), và engine sẽ báo cáo qua nó. 26.6.0 đã từ chối một logger Python với TypeError.

Kết nối OCR Python

GroupDocs.Redaction không đi kèm engine OCR. RedactorSettings(ocr_connector=...) nhận một đối tượng có phương thức recognize(image_stream) trả về những gì engine OCR của bạn tìm thấy: một RecognizedImage chứa các TextLine của các TextFragment, mỗi đoạn có văn bản và hình chữ nhật của nó. Engine sau đó sẽ tìm các cụm từ trong hình ảnh và tô lên chúng. Báo cáo mỗi dòng văn bản dưới dạng một TextFragment. 26.6.0 đã từ chối một kết nối Python với TypeError.

Mức độ tuân thủ OOXML của tài liệu Word đã lưu

SaveOptions.wordprocessing_save_options.ooxml_compliance thiết lập mức độ tuân thủ OOXML của tài liệu Word đã lưu: WordProcessingComplianceLevel.ECMA, TRANSITIONAL hoặc STRICT. Nếu không đặt, tài liệu sẽ giữ mức độ mà nó đã có. 26.6.0 không có tính năng này.

Mở tài liệu dưới dạng một kiểu tệp nhất định

LoadOptions(file_type) mở một stream, hoặc một tệp mà tên không cho biết định dạng, dưới dạng FileType được chỉ định. 26.6.0 không có tính năng này.

Kiểm tra xem giấy phép đã được áp dụng chưa

License().is_licensed sẽ là True ngay khi giấy phép được áp dụng, bằng cách gọi License().set_license() hoặc từ biến môi trường GROUPDOCS_LIC_PATH.

Ví dụ mã

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")

Cách nhận bản cập nhật

PyPI

Nâng cấp qua PyPI:

Cài đặt bằng:

pip install groupdocs-redaction-net==26.11.0

Direct download

Tải wheel cho nền tảng của bạn từ:

Tài nguyên