PyWPDoc — 문서 자동화와 변경 추적

Word DOCX의 템플릿 태그를 미리 검사하고, 치환 대상을 확인하고, 지원되는 변경 내용을 추적 가능한 문서로 저장합니다. 동일한 공통 API는 한컴 HWPX에서도 사용할 수 있습니다.

간단한 설치와 사용법

0.44.0부터:

pip install pywpdoc

이미 PyPI에 게시된 이전 0.44.0rc1 시험 버전은 DOCX 처리를 위해 pip install "pywpdoc[unified]==0.44.0rc1"을 사용해야 합니다. 안정 버전 0.44.0의 실제 게시에는 별도 승인 절차가 있습니다.

from pywpdoc import Document

doc = Document.new("docx")
doc.add_paragraph("Customer: {{customer.name}}")
data = {"customer": {"name": "Acme Corp"}}
report = doc.check_template(data)
if not report.ok:
    raise ValueError(report.missing_keys)
doc.render_template(data)
doc.save("contract.docx")

템플릿 API · 변경 추적 API · 검색·치환 미리보기

실제 문서 출력 이미지

이 이미지는 기존 Word·한컴의 PDF 페이지 출력 기록으로, 신규 0.44.0 테스트나 Track Changes 화면은 아닙니다. 이미지 출처 · 과거 RC 실기 QA.

API 문서 바로가기

전체 공통 Document API · 템플릿 · 변경 추적 · 검색·치환 · 결과·예외 · 설치 · AI 에이전트 가이드

save()는 형식 변환이 아니며, 레거시 바이너리 .hwp는 지원하지 않습니다. 모든 구조적 변경의 추적과 Word·한컴의 완전 동일한 페이지 배치도 보장하지 않습니다. 제한 사항