우리는 GroupDocs.Redaction for Python v26.11의 출시를 기쁘게 발표합니다. 이 버전은 2026년 11월부터 사용할 수 있습니다. 이번 릴리스는 GroupDocs.Redaction 엔진을 26.5에서 26.10으로 업그레이드하고 .NET 런타임 10.0.15를 포함하며, System.Drawing을 Aspose.Drawing 및 SkiaSharp으로 교체하여 크로스 플랫폼 래스터화 및 이미지 영역 레드랙션을 지원합니다(리눅스 및 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] 래스터화된 PDF 출력 및 이미지 영역 레드랙션이 Linux와 macOS에서 PlatformNotSupportedException을 발생 (REDACTIONPYTHONNET-35)
  • [Fix] 탭이 포함된 텍스트에서 레드랙션 콜백이 JSONDecodeError로 실패 (REDACTIONPYTHONNET-36)
  • [Fix] RedactorSettings가 유일한 인수로 전달된 레드랙션 콜백에 대해 TypeError 발생 (REDACTIONPYTHONNET-37)
  • [Fix] Wheels가 포함된 .NET 런타임이 실행될 수 없는 Linux 및 macOS 버전에서 설치 (REDACTIONPYTHONNET-38)

Public 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에서도 내보내집니다.

제거됨

26.6에서 재내보낸 groupdocs.pydrawing 색상; 대신 groupdocs.redaction.options.drawing에서 Color를 가져오세요:

  • groupdocs.redaction.Color
  • groupdocs.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에서는 TypeError로 Python 함수를 거부했습니다.

Python 로거

RedactorSettings(logger=...)는 error(message), warning(message), trace(message) 메서드를 가진 객체를 받아들이며, 엔진은 이를 통해 보고합니다. 26.6.0에서는 TypeError로 Python 로거를 거부했습니다.

Python OCR 커넥터

GroupDocs.Redaction에는 OCR 엔진이 포함되어 있지 않습니다. RedactorSettings(ocr_connector=...)는 recognize(image_stream) 메서드를 가진 객체를 받아들이며, 이 메서드는 OCR 엔진이 찾은 내용을 반환합니다: 텍스트와 사각형을 가진 TextFragment들의 TextLine으로 구성된 RecognizedImage. 엔진은 이미지에서 해당 구절을 찾아 덮어씁니다. 각 텍스트 라인을 하나의 TextFragment로 보고합니다. 26.6.0에서는 TypeError로 Python 커넥터를 거부했습니다.

저장된 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().is_licensed는 라이선스가 적용되면 True가 되며, License().set_license()를 사용하거나 GROUPDOCS_LIC_PATH 환경 변수에서 설정할 수 있습니다.

코드 예시

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을 다음에서 다운로드:

리소스