GroupDocs.Conversion for Python v26.3이 이제 제공됩니다. 이번 릴리스에서는 페이지별 변환, 메모리 스트림 출력, Python 3.14 지원, AI‑agent 통합 파일, 향상된 포맷 메타데이터 및 여러 개선 사항이 추가되었습니다.

이번 릴리스의 새로운 기능

키 카테고리 요약
CONVERSIONPYTHON-65 Feature convert_by_page(output_dir, convert_options)를 통한 페이지별 변환
CONVERSIONPYTHON-66 Feature convert_to_stream(convert_options)를 통한 메모리 변환
CONVERSIONPYTHON-62 Feature Python 3.14 지원
CONVERSIONPYTHON-64 Feature AI Agent 통합을 위한 AGENTS.md를 패키지에 포함
CONVERSIONPYTHON-67 Enhancement 포맷 객체가 .extension, .file_format, .description 속성을 노출
CONVERSIONPYTHON-68 Enhancement PyPI 메타데이터에 명시적인 macOS classifier 추가

공개 API 변경 사항

새 기능 메서드 – 이 메서드들은 25.12에서 선언되었지만 NotImplementedError를 발생시켰습니다. 이제 정상 작동합니다:

메서드 반환값 설명
Converter.convert_by_page(output_dir, convert_options) None 지정된 디렉터리에 페이지당 하나씩 파일을 생성하여 문서를 분할합니다
Converter.convert_to_stream(convert_options) bytes 문서를 변환하고 결과를 메모리 바이트 형태로 반환합니다

아직 사용 불가능한 메서드 – 다음 메서드들은 Converter 클래스의 속성 프록시로 존재하지만 아직 기능을 제공하지 않습니다. 호출 시 예외가 발생합니다:

메서드 상태 우회 방법
convert_by_page(file_path, page_number, convert_options) TypeError — 3‑arg overload not exposed convert_options.page_number와 convert_options.pages_count = 1을 설정한 뒤 convert(file_path, options) 사용
convert_by_page(stream, page_number, convert_options) TypeError — 3‑arg overload not exposed 파일로 변환한 뒤 io.BytesIO에 읽어들임
convert_multiple(folder_path, convert_options) MissingMethodException 아카이브에서 단일 파일 출력으로 통합하려면 convert(file_path, options) 사용

새로운 기능

페이지별 변환 – convert_by_page
Converter.convert_by_page(output_dir, convert_options) 메서드가 이제 완전하게 동작합니다. 다중 페이지 문서를 개별 파일(페이지당 하나)로 분할하여 지정된 디렉터리에 저장합니다. 페이지 파일은 page_1.ext, page_2.ext와 같은 이름으로 생성됩니다. 이 메서드는 ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions 등 페이지 기반 출력을 지원하는 모든 ConvertOptions 클래스에서 작동합니다.

메모리 변환 – convert_to_stream
Converter.convert_to_stream(convert_options) 메서드는 이제 변환된 문서를 Python bytes 객체로 반환합니다. 이를 통해 디스크에 쓰지 않고 메모리 내에서 변환 파이프라인을 구성할 수 있어, 파일 시스템 접근이 제한되거나 원치 않는 클라우드 함수, 웹 애플리케이션, 스트리밍 아키텍처에 유용합니다.

Python 3.14 지원
지원되는 Python 버전 범위가 3.5–3.13(25.12)에서 3.5–3.14로 확대되었습니다. Requires-Python 메타데이터는 이제 >=3.5,<3.15를 표시하며, PyPI 페이지에는 Python 3.8부터 3.14까지의 classifier가 명시됩니다.

AGENTS.md – AI Agent 및 LLM 통합
groupdocs-conversion pip 패키지는 이제 휠 내부 groupdocs/conversion/AGENTS.md 경로에 AGENTS.md 파일을 포함합니다. Claude Code, Cursor, GitHub Copilot 등 설치된 패키지를 스캔하는 AI 코딩 어시스턴트가 API 표면, 사용 패턴, import 경로 및 문제 해결 팁을 자동으로 발견할 수 있습니다.

포맷 객체 속성
get_possible_conversions() 및 get_all_possible_conversions()이 반환하는 포맷 객체는 이제 사람이 읽을 수 있는 속성을 제공합니다:

  • .extension – 예: 'pdf'
  • .file_format – 예: 'Portable Document Format'
  • .description – 예: 'Portable Document Format File (pdf)'

이전에는 객체가 불투명한 <NetObject handle=NNN> 형태로 표시되었지만, 이제 repr()에서 <NetObject pdf>와 같이 표시되고 위에 나열된 속성을 통해 깔끔한 문자열 값을 얻을 수 있습니다.

코드 예제

import os
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

output_dir = "./converted-pages"
os.makedirs(output_dir, exist_ok=True)

with Converter("./presentation.pptx") as converter:
    options = ImageConvertOptions()
    options.format = ImageFileType.PNG
    converter.convert_by_page(output_dir, options)
    # produces: page_1.png, page_2.png, ...

업데이트 방법

PyPI

pip install --upgrade groupdocs-conversion

리소스