Z przyjemnością ogłaszamy wydanie GroupDocs.Redaction for Python v26.11, dostępny od listopada 2026. To wydanie aktualizuje silnik GroupDocs.Redaction z 26.5 do 26.10 i wbudowuje runtime .NET 10.0.15, zastępując System.Drawing przez Aspose.Drawing i SkiaSharp w celu rasteryzacji wieloplatformowej oraz redakcji obszarów obrazu — w tym Linux i macOS. Nowe funkcje obejmują podglądy stron, obsługę rejestratora Python, integrację łącznika OCR dla Pythona, kontrolę zgodności OOXML dla dokumentów Word, jawne ładowanie typu pliku oraz sprawdzanie statusu licencji.

Co nowego w tej wersji

  • [Feature] Dodaj obsługę podglądów stron dla plików i io.BytesIO (PreviewOptions, generate_preview()) (REDACTIONPYTHONNET-23)
  • [Feature] Dodaj obsługę rejestratora Python (ILogger) (REDACTIONPYTHONNET-24)
  • [Feature] Dodaj obsługę łącznika OCR dla Pythona (IOcrConnector) do redagowania tekstu na obrazach (REDACTIONPYTHONNET-25)
  • [Feature] Dodaj obsługę ustawiania poziomu zgodności OOXML zapisanego dokumentu Word (ooxml_compliance) (REDACTIONPYTHONNET-26)
  • [Feature] Dodaj obsługę otwierania dokumentu jako określony typ pliku (LoadOptions.file_type) (REDACTIONPYTHONNET-27)
  • [Feature] Dodaj obsługę sprawdzania, czy licencja jest zastosowana (License.is_licensed) (REDACTIONPYTHONNET-28)
  • [Enhancement] Zaktualizuj GroupDocs.Redaction do 26.10 i wbudowany runtime do .NET 10.0.15 (REDACTIONPYTHONNET-29)
  • [Enhancement] Zastąp typy groupdocs.pydrawing typami groupdocs.redaction.options.drawing (Color, Point, Size, Rectangle, Font, FontStyle) (REDACTIONPYTHONNET-30)
  • [Enhancement] Zwracaj wyliczenia RedactionType i RedactionActionType z opisu wywołania zwrotnego redakcji (REDACTIONPYTHONNET-31)
  • [Enhancement] Rzuć AttributeError, gdy nieznany atrybut zostanie przypisany do obiektu API (REDACTIONPYTHONNET-32)
  • [Enhancement] Rzuć LicenseError dla licencji, której nie można zastosować, oraz wyeksportuj go i GroupDocsRedactionException z groupdocs.redaction (REDACTIONPYTHONNET-33)
  • [Enhancement] Zainstaluj groupdocs.pydrawing i groupdocs.pycore z współdzielonego pakietu groupdocs-shared-net (REDACTIONPYTHONNET-34)
  • [Fix] Napraw wykryte CVE w wersji 26.6.0: runtime .NET 10.0.0 → 10.0.15 (+2 kolejne) (REDACTIONPYTHONNET-12)
  • [Fix] Rasterizowane wyjście PDF i redakcja obszaru obrazu powodują PlatformNotSupportedException na Linux i macOS (REDACTIONPYTHONNET-35)
  • [Fix] Wywołanie zwrotne redakcji kończy się niepowodzeniem z JSONDecodeError przy tekście zawierającym tabulację (REDACTIONPYTHONNET-36)
  • [Fix] RedactorSettings rzuca TypeError dla wywołania zwrotnego redakcji przekazanego jako jedyny argument (REDACTIONPYTHONNET-37)
  • [Fix] Pakiety Wheel instalują się na wersjach Linux i macOS, na których wbudowany runtime .NET nie może działać (REDACTIONPYTHONNET-38)

Zmiany w publicznym API

Użytkownicy aktualizujący muszą importować kolory i geometrię z groupdocs.redaction.options.drawing oraz porównywać redaction_type i action_type wywołania zwrotnego redakcji z członkami wyliczeń. Wszystko inne jest dodatkiem.

Nowe klasy i członkowie

  • 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 jest nowym modułem. GroupDocsRedactionException jest nadal eksportowany również przez groupdocs.redaction.exceptions too.

Usunięte

Kolor groupdocs.pydrawing, który był ponownie eksportowany w wersji 26.6; zamiast tego importuj Color z groupdocs.redaction.options.drawing:

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

Zmienione

  • Każdy członek, który przyjmuje lub zwraca kolor, punkt, rozmiar lub prostokąt, używa typów groupdocs.redaction.options.drawing. Wartość groupdocs.pydrawing powoduje TypeError (brak dopasowanego przeciążenia).
  • RedactionDescription.redaction_type i action_type, które odczytuje wywołanie zwrotne redakcji, są członkami RedactionType i RedactionActionType.
  • Przestarzałe aliasy silnika są również dostępne: ReplacementOptions.box_fill_color, RegionReplacementOptions.area_fill_color i area_size, ImageAreaRedaction.top_left_position, PageAreaFilter.area_rectangle oraz TextFragment.bounding_rectangle. Używaj box_color, fill_color, size, top_left i rectangle.

Nowe funkcje

Podglądy stron

Redactor.generate_preview() renderuje strony dokumentu jako obrazy. PreviewOptions przyjmuje funkcję zwracającą strumień dla każdej strony, otwarty plik binarny lub io.BytesIO, oraz opcjonalnie drugą funkcję zwalniającą strumień każdej strony. Ustaw width, height i page_numbers. W wersji 26.6.0 funkcja Pythona była odrzucana z TypeError.

Rejestrator Python

RedactorSettings(logger=...) przyjmuje obiekt z metodami error(message), warning(message) i trace(message), a silnik raportuje przez niego. W wersji 26.6.0 rejestrator Python był odrzucany z TypeError.

Łącznik OCR dla Pythona

GroupDocs.Redaction nie dostarcza silnika OCR. RedactorSettings(ocr_connector=...) przyjmuje obiekt z metodą recognize(image_stream), która zwraca to, co znalazł Twój silnik OCR: RecognizedImage zawierający TextLiney z TextFragmentami, każdy z tekstem i prostokątem. Silnik następnie znajduje frazy na obrazie i maluje je. Zgłaszaj każdą linię tekstu jako jeden TextFragment. W wersji 26.6.0 łącznik Python był odrzucany z TypeError.

Poziom zgodności OOXML zapisanego dokumentu Word

SaveOptions.wordprocessing_save_options.ooxml_compliance ustawia poziom zgodności OOXML zapisanego dokumentu Word: WordProcessingComplianceLevel.ECMA, TRANSITIONAL lub STRICT. Jeśli nie ustawione, dokument zachowuje poprzedni poziom. W wersji 26.6.0 nie było tej opcji.

Otwórz dokument jako określony typ pliku

LoadOptions(file_type) otwiera strumień lub plik, którego nazwa nie wskazuje formatu, jako podany FileType. W wersji 26.6.0 nie było tej funkcji.

Sprawdź, czy licencja jest zastosowana

License().is_licensed zwraca True, gdy licencja zostanie zastosowana, przy użyciu License().set_license() lub zmiennej środowiskowej GROUPDOCS_LIC_PATH.

Przykład kodu

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

Jak uzyskać aktualizację

PyPI

Uaktualnij przez PyPI:

Zainstaluj przy użyciu:

pip install groupdocs-redaction-net==26.11.0

Bezpośrednie pobranie

Pobierz pakiet wheel dla swojej platformy z:

Zasoby