Temos o prazer de anunciar o lançamento do GroupDocs.Redaction for Python v26.11, disponível a partir de novembro de 2026. Esta versão atualiza o mecanismo GroupDocs.Redaction de 26.5 para 26.10 e incorpora o runtime .NET 10.0.15, substituindo System.Drawing por Aspose.Drawing e SkiaSharp para rasterização multiplataforma e redação de áreas de imagem — incluindo Linux e macOS. Novos recursos incluem pré‑visualizações de página, suporte a logger Python, integração do conector OCR Python, controle de conformidade OOXML para documentos Word, carregamento explícito de tipo de arquivo e verificação de status da licença.

O que há de novo nesta versão

  • [Feature] Adicionar suporte a pré‑visualizações de página para arquivos e io.BytesIO (PreviewOptions, generate_preview()) (REDACTIONPYTHONNET-23)
  • [Feature] Adicionar suporte a um logger Python (ILogger) (REDACTIONPYTHONNET-24)
  • [Feature] Adicionar suporte a um conector OCR Python (IOcrConnector) para redigir texto em imagens (REDACTIONPYTHONNET-25)
  • [Feature] Adicionar suporte à definição do nível de conformidade OOXML de um documento Word salvo (ooxml_compliance) (REDACTIONPYTHONNET-26)
  • [Feature] Adicionar suporte à abertura de um documento como um tipo de arquivo especificado (LoadOptions.file_type) (REDACTIONPYTHONNET-27)
  • [Feature] Adicionar suporte à verificação se uma licença foi aplicada (License.is_licensed) (REDACTIONPYTHONNET-28)
  • [Enhancement] Atualizar GroupDocs.Redaction para 26.10 e o runtime incorporado para .NET 10.0.15 (REDACTIONPYTHONNET-29)
  • [Enhancement] Substituir tipos groupdocs.pydrawing por groupdocs.redaction.options.drawing (Color, Point, Size, Rectangle, Font, FontStyle) (REDACTIONPYTHONNET-30)
  • [Enhancement] Retornar enums RedactionType e RedactionActionType a partir da descrição de um callback de redação (REDACTIONPYTHONNET-31)
  • [Enhancement] Levantar AttributeError quando um atributo desconhecido é atribuído a um objeto da API (REDACTIONPYTHONNET-32)
  • [Enhancement] Levantar LicenseError para uma licença que não pode ser aplicada, e exportá‑lo juntamente com GroupDocsRedactionException de groupdocs.redaction (REDACTIONPYTHONNET-33)
  • [Enhancement] Instalar groupdocs.pydrawing e groupdocs.pycore a partir do pacote compartilhado groupdocs-shared-net (REDACTIONPYTHONNET-34)
  • [Fix] Corrigir vulnerabilidades CVE em 26.6.0: runtime .NET 10.0.0 → 10.0.15 (+2 adicionais) (REDACTIONPYTHONNET-12)
  • [Fix] Saída PDF rasterizada e redação de área de imagem levantam PlatformNotSupportedException no Linux e macOS (REDACTIONPYTHONNET-35)
  • [Fix] Um callback de redação falha com JSONDecodeError em texto que contém uma tabulação (REDACTIONPYTHONNET-36)
  • [Fix] RedactorSettings levanta TypeError para um callback de redação passado como seu único argumento (REDACTIONPYTHONNET-37)
  • [Fix] Wheels instalam em versões Linux e macOS nas quais o runtime .NET incorporado não pode ser executado (REDACTIONPYTHONNET-38)

Alterações na API Pública

Os usuários que atualizam precisam importar cores e geometria de groupdocs.redaction.options.drawing, e comparar redaction_type e action_type de um callback de redação com membros de enumeração. Todo o resto é aditivo.

Novas classes e membros

  • 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 é um novo módulo. GroupDocsRedactionException ainda é exportado por groupdocs.redaction.exceptions também.

Removido

A cor groupdocs.pydrawing que o 26.6 reexportava; importe Color de groupdocs.redaction.options.drawing em vez disso:

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

Alterado

  • Todo membro que aceita ou retorna uma cor, ponto, tamanho ou retângulo usa os tipos groupdocs.redaction.options.drawing. Um valor groupdocs.pydrawing levanta TypeError (nenhuma sobrecarga corresponde).
  • RedactionDescription.redaction_type e action_type, que um callback de redação lê, são membros RedactionType e RedactionActionType.
  • Os aliases obsoletos do mecanismo também estão presentes: ReplacementOptions.box_fill_color, RegionReplacementOptions.area_fill_color e area_size, ImageAreaRedaction.top_left_position, PageAreaFilter.area_rectangle e TextFragment.bounding_rectangle. Use box_color, fill_color, size, top_left e rectangle.

Novos recursos

Pré‑visualizações de página

Redactor.generate_preview() renderiza as páginas do documento em imagens. PreviewOptions aceita uma função que retorna um stream para cada página, um arquivo binário aberto ou um io.BytesIO, e opcionalmente uma segunda função que libera o stream de cada página. Defina width, height e page_numbers. O 26.6.0 recusou uma função Python aí com TypeError.

Logger Python

RedactorSettings(logger=...) aceita um objeto com error(message), warning(message) e trace(message), e o mecanismo reporta através dele. O 26.6.0 recusou um logger Python com TypeError.

Conector OCR Python

GroupDocs.Redaction não inclui um motor OCR. RedactorSettings(ocr_connector=...) aceita um objeto com recognize(image_stream) que devolve o que seu motor OCR encontrou: um RecognizedImage de TextLines de TextFragments, cada um com seu texto e retângulo. O mecanismo então encontra as frases na imagem e as pinta por cima. Relate cada linha de texto como um TextFragment. O 26.6.0 recusou um conector Python com TypeError.

Nível de conformidade OOXML de um documento Word salvo

SaveOptions.wordprocessing_save_options.ooxml_compliance define o nível de conformidade OOXML de um documento Word salvo: WordProcessingComplianceLevel.ECMA, TRANSITIONAL ou STRICT. Se não definido, o documento mantém o nível que possuía. O 26.6.0 não o possuía.

Abrir um documento como um tipo de arquivo especificado

LoadOptions(file_type) abre um stream, ou um arquivo cujo nome não indica seu formato, como o FileType especificado. O 26.6.0 não o possuía.

Verificar se uma licença foi aplicada

License().is_licensed é True assim que uma licença é aplicada, com License().set_license() ou a partir da variável de ambiente GROUPDOCS_LIC_PATH.

Exemplo de código

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

Como obter a atualização

PyPI

Atualize via PyPI:

Instale com:

pip install groupdocs-redaction-net==26.11.0

Download direto

Baixe o wheel para sua plataforma em:

Recursos