우리는 GroupDocs.Editor for Python v26.5의 릴리스를 발표하게 되어 기쁩니다. 이 릴리스는 2026년 5월부터 제공됩니다. .NET을 통해 제공되는 GroupDocs.Editor for Python의 첫 번째 공개 릴리스이며, PyPI에 자체 포함된 Python wheel 형태로 배포됩니다. 기본 .NET 라이브러리의 전체 문서 편집 기능을 Python에 제공하여, 문서를 로드하고 깨끗하고 편집 가능한 HTML/CSS로 변환한 뒤, 프로그램matically 또는 任意의 WYSIWYG 편집기에서 마크업을 수정하고, 원본 형식이나 다른 형식으로 다시 저장할 수 있습니다. 단일 pip install만으로 MS Office, OpenOffice, 별도 .NET 런타임이 필요하지 않습니다.

이번 릴리스의 새로운 기능

  • [새 기능] HTML 라운드트립 편집 (EDTPY-1)
  • [새 기능] 자동 매핑된 명명 규칙을 갖춘 파이썬 친화적 API 표면 (EDTPY-2)
  • [새 기능] 워드 프로세싱, 스프레드시트, 프레젠테이션, PDF, 이메일, 전자책, 텍스트/마크업 형식을 아우르는 다중 형식 지원 (EDTPY-3)
  • [새 기능] HTML 중간 단계 기반 형식 변환 (EDTPY-4)
  • [새 기능] 페이지네이션 및 언어 메타데이터 토글을 포함한 세분화된 편집 (워크시트/슬라이드/페이지 범위) (EDTPY-5)
  • [새 기능] 리소스 추출(이미지, 폰트, CSS, 오디오) 및 폴더 영속성 (EDTPY-6)
  • [새 기능] get_document_info() 를 통한 문서 인스펙션 (EDTPY-7)
  • [새 기능] editor.form_field_manager 로 폼 필드 검사 및 업데이트 (EDTPY-8)
  • [새 기능] 스트림 로딩 및 결정적 해제를 위한 컨텍스트 매니저 프로토콜 (EDTPY-9)
  • [새 기능] AI 에이전트 및 LLM 친화적: 번들된 AGENTS.md, MCP 서버, 그리고 기계가 읽을 수 있는 문서 (EDTPY-10)

공개 API 변경 사항

전체 .NET API가 Python 네이티브 명명 규칙으로 노출됩니다. 클래스는 PascalCase를 사용하고, 메서드와 속성은 snake_case(기본 .NET PascalCase에 자동 매핑)이며, 열거형 값은 UPPER_SNAKE_CASE를 사용합니다.

클래스

  • Editor — 진입점; 경로나 스트림으로 열고, edit(), save(), get_document_info(), form_field_manager 제공
  • EditableDocument — HTML/CSS 표현; get_content(), get_body_content(), get_embedded_html(), get_css_content(), save(), 리소스 컬렉션(images, fonts, css, audio, all_resources), 그리고 from_markup() / from_markup_and_resource_folder() / from_file() 팩토리 메서드
  • FormFieldManager — 워드 프로세싱 폼 필드 읽기 및 업데이트
  • License, Metered — 라이선스 API

옵션

  • 로드: WordProcessingLoadOptions, SpreadsheetLoadOptions, PresentationLoadOptions, PdfLoadOptions
  • 편집: WordProcessingEditOptions, SpreadsheetEditOptions, PresentationEditOptions, PdfEditOptions, EbookEditOptions, EmailEditOptions, MarkdownEditOptions, TextEditOptions, XmlEditOptions, DelimitedTextEditOptions
  • 저장: WordProcessingSaveOptions, SpreadsheetSaveOptions, PresentationSaveOptions, PdfSaveOptions, HtmlSaveOptions, MhtmlSaveOptions, MarkdownSaveOptions, XpsSaveOptions, TextSaveOptions, EbookSaveOptions, EmailSaveOptions, DelimitedTextSaveOptions

열거형

  • WordProcessingFormats, SpreadsheetFormats, PresentationFormats, FixedLayoutFormats, EBookFormats, EmailFormats, TextualFormats, FontExtractionOptions, FontEmbeddingOptions

예외

  • PasswordRequiredException, IncorrectPasswordException, EncryptedException, InvalidFormatException

새로운 기능

HTML 라운드트립 편집

지원되는 모든 문서를 편집 가능한 HTML/CSS로 변환하고, 원본 형식으로 다시 저장하면서 품질 손실 없이 작업할 수 있습니다. 이는 GroupDocs.Editor의 핵심 워크플로우이며, HTML은 프로그래밍 방식이나 CKEditor, TinyMCE와 같은 서드파티 WYSIWYG 편집기에서 수정할 수 있습니다.

파이썬 친화적 API 표면

전체 .NET API가 Python 네이티브 명명 규칙으로 노출됩니다. 클래스는 PascalCase, 메서드와 속성은 snake_case, 열거형 값은 UPPER_SNAKE_CASE를 사용합니다.

다중 형식 지원

워드 프로세싱, 스프레드시트, 프레젠테이션, PDF, 이메일, 전자책, 텍스트/마크업 형식을 아우르는 하나의 통합 API.

HTML 기반 형식 변환

별도의 “convert” 호출이 필요 없습니다. 다른 *SaveOptions를 사용해 EditableDocument를 저장하면 HTML 중간 단계로 자동 변환됩니다. 동일한 입력, 다른 출력.

세분화된 편집

워크북의 단일 워크시트, 프레젠테이션의 단일 슬라이드, 혹은 페이지 범위를 편집하고, 페이지네이션 및 언어 메타데이터를 토글할 수 있습니다.

리소스 추출

EditableDocument는 추출된 이미지, 폰트, CSS, 오디오를 반복 가능한 컬렉션으로 제공하며, HTML과 모든 리소스를 폴더에 영속화할 수 있습니다.

문서 인스펙션

전체 편집 과정을 거치지 않고도 형식, 페이지 수, 크기, 암호화 상태 등을 읽어올 수 있습니다.

폼 필드

editor.form_field_manager를 통해 워드 프로세싱 폼 필드를 검사하고 업데이트합니다.

스트림 및 컨텍스트 매니저

임의의 바이너리 스트림에서 로드하고, 컨텍스트 매니저 프로토콜을 사용해 네이티브 문서 핸들의 결정적 해제를 보장합니다.

AI 에이전트 및 LLM 친화적

  • AGENTS.md 번들된 파일 — Claude Code, Cursor, GitHub Copilot이 API 표면, 사용 패턴, 트러블슈팅 힌트를 자동으로 발견합니다.
  • MCP 서버 — AI 도구를 https://docs.groupdocs.com/mcp에 연결해 필요 시 문서를 조회합니다.
  • 기계가 읽을 수 있는 문서 — https://docs.groupdocs.com/editor/python-net/llms-full.txt에서 RAG 및 LLM 컨텍스트용 문서를 제공합니다.

코드 예시

from groupdocs.editor import Editor, EditableDocument
from groupdocs.editor.formats import WordProcessingFormats
from groupdocs.editor.options import WordProcessingSaveOptions

with Editor("document.docx") as editor:
    editable = editor.edit()                       # document -> editable HTML
    html = editable.get_embedded_html()
    edited = EditableDocument.from_markup(html.replace("Hello", "Goodbye"))
    editor.save(edited, "document.docx", WordProcessingSaveOptions(WordProcessingFormats.DOCX))

업데이트 방법

PyPI

다음 명령으로 설치하거나 업그레이드합니다:

pip install groupdocs-editor-net

직접 다운로드

GroupDocs.Editor for Python via .NET 26.5 페이지에서 wheel 파일을 다운로드하십시오.

리소스