설치와 빠른 시작
0.44.0부터는 한 번의 설치로 Word DOCX와 한컴 HWPX 둘 다 사용할 수 있습니다.
pip install pywpdoc
기존 PyPI 시험 버전 0.44.0rc1에서 DOCX를 사용하려면 pip install "pywpdoc[unified]==0.44.0rc1"을 실행합니다. 0.44.0 새 버전의 실제 게시 여부는 PyPI에서 확인하세요.
from pywpdoc import Document
doc = Document.new("docx")
doc.add_paragraph("Hello, PyWPDoc!")
doc.save("hello.docx")
- Python 3.10 이상이 필요합니다.
- 기본 의존성에
python-docx가 포함되며 기존[unified]설치 옵션도 계속 허용합니다. - Word·한컴 데스크톱 프로그램이 없어도 일반 문서 생성·편집이 가능합니다. 해당 프로그램에서 실제 PDF/레이아웃 검증 시에는 설치가 필요합니다.
전체 실행 예제: examples/manual/quickstart.py
"""Quick start: generate DOCX and HWPX with the same public API."""
from pathlib import Path
from pywpdoc import Document
def run(out_dir: Path) -> list[Path]:
out_dir.mkdir(parents=True, exist_ok=True)
results = []
for fmt in ("docx", "hwpx"):
doc = Document.new(fmt)
doc.add_paragraph("Quarterly report / 분기 보고서")
table = doc.add_table(2, 2)
for row, cells in enumerate((("Item", "Qty"), ("Notebook", "12"))):
for col, value in enumerate(cells):
table.cell(row, col).text = value
path = out_dir / f"quickstart.{fmt}"
doc.save(path)
results.append(path)
return results
if __name__ == "__main__":
import sys
for path in run(Path(sys.argv[1] if len(sys.argv) > 1 else ".")):
print(path)
python examples/manual/quickstart.py ./output으로 quickstart.docx와 quickstart.hwpx를 생성할 수 있습니다.