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.pydrawingporgroupdocs.redaction.options.drawing(Color,Point,Size,Rectangle,Font,FontStyle) (REDACTIONPYTHONNET-30) - [Enhancement] Retornar enums
RedactionTypeeRedactionActionTypea partir da descrição de um callback de redação (REDACTIONPYTHONNET-31) - [Enhancement] Levantar
AttributeErrorquando um atributo desconhecido é atribuído a um objeto da API (REDACTIONPYTHONNET-32) - [Enhancement] Levantar
LicenseErrorpara uma licença que não pode ser aplicada, e exportá‑lo juntamente comGroupDocsRedactionExceptiondegroupdocs.redaction(REDACTIONPYTHONNET-33) - [Enhancement] Instalar
groupdocs.pydrawingegroupdocs.pycorea partir do pacote compartilhadogroupdocs-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
PlatformNotSupportedExceptionno Linux e macOS (REDACTIONPYTHONNET-35) - [Fix] Um callback de redação falha com
JSONDecodeErrorem texto que contém uma tabulação (REDACTIONPYTHONNET-36) - [Fix]
RedactorSettingslevantaTypeErrorpara 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.Colorgroupdocs.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 valorgroupdocs.pydrawinglevantaTypeError(nenhuma sobrecarga corresponde). RedactionDescription.redaction_typeeaction_type, que um callback de redação lê, são membrosRedactionTypeeRedactionActionType.- Os aliases obsoletos do mecanismo também estão presentes:
ReplacementOptions.box_fill_color,RegionReplacementOptions.area_fill_colorearea_size,ImageAreaRedaction.top_left_position,PageAreaFilter.area_rectangleeTextFragment.bounding_rectangle. Usebox_color,fill_color,size,top_lefterectangle.
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:
- GroupDocs.Redaction para Python via .NET 26.11 – Windows
- GroupDocs.Redaction para Python via .NET 26.11 – Linux
- GroupDocs.Redaction para Python via .NET 26.11 – macOS Intel
- GroupDocs.Redaction para Python via .NET 26.11 – macOS Apple Silicon