우리는 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.Colorgroupdocs.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을 다음에서 다운로드:
- GroupDocs.Redaction for Python via .NET 26.11 – Windows
- GroupDocs.Redaction for Python via .NET 26.11 – Linux
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Intel
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Apple Silicon