python-hwpx 5.7.0__tar.gz → 6.0.2__tar.gz

{python_hwpx-5.7.0 → python_hwpx-6.0.2}/NOTICE

@@ -58,6 +58,14 @@ neolord0/hwpxlib (https://github.com/neolord0/hwpxlib), licensed Apache-2.0.
 Only sample DATA files are vendored; no hwpxlib source code or structure is
 copied (clean-room). Pinned ref is recorded in manifest.json.
 
+## Hancom file-format specification attribution
+
+Parts of this project were developed with reference to the publicly
+released Hancom file-format documentation (HWP 5.0 / HWPML) and the
+public OWPML schema. As required by that documentation:
+
+“본 제품은 한글과컴퓨터의 ᄒᆞᆫ글 문서 파일(.hwp) 공개 문서를 참고하여 개발하였습니다.”
+
 ────────────────────────────────────────
 DISCLAIMER — HWPX Format
 

{python_hwpx-5.7.0/src/python_hwpx.egg-info → python_hwpx-6.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 5.7.0
+Version: 6.0.2
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -100,16 +100,21 @@ AI 도구가 정확한 API를 배우도록 [llms.txt](https://airmang.github.io/
 pip install python-hwpx      # Python 3.10+
 ```
 
+<!-- standalone-python-example -->
+
 ```python
 from hwpx import HwpxDocument
 
-doc = HwpxDocument.open("보고서.hwpx")
-doc.add_paragraph("자동화로 추가한 문단입니다.")
-doc.save_to_path("보고서-수정.hwpx")
+doc = HwpxDocument.new()
+doc.add_heading("2026 운영계획", level=1)
+doc.add_paragraph("가. 추진 배경", style="개요 2")
+doc.save_to_path("계획.hwpx")
 ```
 
-백지에서 시작할 때는 `HwpxDocument.new()`로 만들어 같은 API로 문단·표·머리말을
-채우면 됩니다. 문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
+스타일은 이름으로 지정하고, 오타는 저장이 아니라 **그 줄에서** 잡힌다.
+기존 문서를 고치려면 `HwpxDocument.open("보고서.hwpx")`로 시작하면 된다.
+
+문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
 [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)을
 함께 설치하세요.
 
@@ -158,10 +163,15 @@ print(report.preservation.untouched_part_payloads.to_dict())
 
 ## 실측으로 말합니다
 
-만든 파일이 실제 한컴오피스에서 열리는지, 동결 코퍼스 전수(N=497)를 재서
-그대로 공개합니다:
+만든 파일이 실제 한컴오피스에서 열리는지 재서 그대로 공개합니다. 측정마다
+스택과 날짜를 병기합니다:
 
-- **한컴 열림 476/476** — 우리가 만든 파일을 실한컴이 전부 엽니다
+- **한컴 열림 120/120 · 렌더 검증 120/120** — 현행 스택(5.7.0 · 실한컴
+  12.0.0.3288 · 2026-08-03)의 축소 측정: 기준 스트라텀 + 신규 저작 표면
+  6종(각주·누름틀·수식·차트·체크박스·편집 계획). 영수증은 행마다 bucket이
+  있어 `jq` 한 줄로 재현됩니다
+- **한컴 열림 476/476** — 전수 동결 코퍼스(N=497) 측정
+  (3.4.1 · 실한컴 12.0.0.3288 · 2026-07-19)
 - **미수정 영역 바이트 보존 497/497** · 개인정보 유출 0
 - **렌더 검증 416/476** — 한컴 자체가 PDF 내보내기를 거부한 43건도 숨기지 않고 집계
 - 전체 수치와 주의사항: [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html) · 기능별 등급: [지원 매트릭스](docs/support-matrix.md)

{python_hwpx-5.7.0 → python_hwpx-6.0.2}/README.md

@@ -49,16 +49,21 @@ AI 도구가 정확한 API를 배우도록 [llms.txt](https://airmang.github.io/
 pip install python-hwpx      # Python 3.10+
 ```
 
+<!-- standalone-python-example -->
+
 ```python
 from hwpx import HwpxDocument
 
-doc = HwpxDocument.open("보고서.hwpx")
-doc.add_paragraph("자동화로 추가한 문단입니다.")
-doc.save_to_path("보고서-수정.hwpx")
+doc = HwpxDocument.new()
+doc.add_heading("2026 운영계획", level=1)
+doc.add_paragraph("가. 추진 배경", style="개요 2")
+doc.save_to_path("계획.hwpx")
 ```
 
-백지에서 시작할 때는 `HwpxDocument.new()`로 만들어 같은 API로 문단·표·머리말을
-채우면 됩니다. 문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
+스타일은 이름으로 지정하고, 오타는 저장이 아니라 **그 줄에서** 잡힌다.
+기존 문서를 고치려면 `HwpxDocument.open("보고서.hwpx")`로 시작하면 된다.
+
+문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
 [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)을
 함께 설치하세요.
 
@@ -107,10 +112,15 @@ print(report.preservation.untouched_part_payloads.to_dict())
 
 ## 실측으로 말합니다
 
-만든 파일이 실제 한컴오피스에서 열리는지, 동결 코퍼스 전수(N=497)를 재서
-그대로 공개합니다:
+만든 파일이 실제 한컴오피스에서 열리는지 재서 그대로 공개합니다. 측정마다
+스택과 날짜를 병기합니다:
 
-- **한컴 열림 476/476** — 우리가 만든 파일을 실한컴이 전부 엽니다
+- **한컴 열림 120/120 · 렌더 검증 120/120** — 현행 스택(5.7.0 · 실한컴
+  12.0.0.3288 · 2026-08-03)의 축소 측정: 기준 스트라텀 + 신규 저작 표면
+  6종(각주·누름틀·수식·차트·체크박스·편집 계획). 영수증은 행마다 bucket이
+  있어 `jq` 한 줄로 재현됩니다
+- **한컴 열림 476/476** — 전수 동결 코퍼스(N=497) 측정
+  (3.4.1 · 실한컴 12.0.0.3288 · 2026-07-19)
 - **미수정 영역 바이트 보존 497/497** · 개인정보 유출 0
 - **렌더 검증 416/476** — 한컴 자체가 PDF 내보내기를 거부한 43건도 숨기지 않고 집계
 - 전체 수치와 주의사항: [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html) · 기능별 등급: [지원 매트릭스](docs/support-matrix.md)

{python_hwpx-5.7.0 → python_hwpx-6.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "5.7.0"
+version = "6.0.2"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
@@ -102,11 +102,17 @@ include-package-data = true
 packages = [
     "hwpx",
     "hwpx._document",
+    # 6.0: 루트 표면 34 뒤의 11개 도메인 네임스페이스. 이 줄이 없으면 휠이
+    # `hwpx._document.ns` 없이 나가고 `import hwpx` 자체가 깨진다 — 소스
+    # 트리에서만 통과하는 종류의 결함이라 doc-fence 휠 실행 게이트가 잡았다.
+    "hwpx._document.ns",
     "hwpx.data",
     "hwpx.equation",
     "hwpx.form_fit",
     "hwpx.ingest",
     "hwpx.layout",
+    # 6.0: add_* 가 반환하는 도메인 객체·결과 dataclass (WP-C가 채운다).
+    "hwpx.objects",
     "hwpx.opc",
     "hwpx.oxml",
     "hwpx.plan",
@@ -162,6 +168,28 @@ files = [
     "src/hwpx/tools/mail_merge.py",
     "src/hwpx/tools/redline.py",
     "src/hwpx/_document/_units.py",
+    # 6.0 (062-engine-surface WP-A): 새 모듈은 게이트 안에서 태어난다. 이
+    # 목록이 옛 모듈을 점진 편입하는 것이라고 해서, 새로 만드는 것까지 밖에
+    # 둘 이유는 없다.
+    #
+    # 예외 하나: `_document/_legacy.py`. 본문이 5.8.0 `document.py`의 것을
+    # **그대로** 옮긴 것이고(그 자리에서는 타입 청결했다), 믹스인으로 분리된
+    # 탓에 `self`가 `HwpxDocument`가 아니라 `Self@_LegacyFacade`로 좁혀져
+    # 위임 호출 52건이 전부 같은 한 가지 이유로 붉어진다. `self` 주석을 달면
+    # `inspect.signature`가 바뀌어 shim 락의 시그니처 동일성(이주 창의 핵심
+    # 약속)이 깨진다. 7.0에서 파일째 삭제되므로 편입하지 않는다.
+    "src/hwpx/model.py",
+    "src/hwpx/objects/__init__.py",
+    # 6.0 (062-engine-surface WP-C): 반환 규약 소유 모듈 5종 — 같은 이유로
+    # 게이트 안에서 태어난다(위 WP-A 주석 참조).
+    "src/hwpx/objects/binary_item.py",
+    "src/hwpx/objects/checkbox.py",
+    "src/hwpx/objects/form_field.py",
+    "src/hwpx/objects/results.py",
+    "src/hwpx/objects/tracked.py",
+    "src/hwpx/_document/_resolve.py",
+    "src/hwpx/_document/headings.py",
+    "src/hwpx/_document/ns",
     "src/hwpx/_document/fields.py",
     "src/hwpx/_document/layout.py",
     "src/hwpx/_document/media.py",
@@ -223,6 +251,28 @@ include = [
     "src/hwpx/tools/mail_merge.py",
     "src/hwpx/tools/redline.py",
     "src/hwpx/_document/_units.py",
+    # 6.0 (062-engine-surface WP-A): 새 모듈은 게이트 안에서 태어난다. 이
+    # 목록이 옛 모듈을 점진 편입하는 것이라고 해서, 새로 만드는 것까지 밖에
+    # 둘 이유는 없다.
+    #
+    # 예외 하나: `_document/_legacy.py`. 본문이 5.8.0 `document.py`의 것을
+    # **그대로** 옮긴 것이고(그 자리에서는 타입 청결했다), 믹스인으로 분리된
+    # 탓에 `self`가 `HwpxDocument`가 아니라 `Self@_LegacyFacade`로 좁혀져
+    # 위임 호출 52건이 전부 같은 한 가지 이유로 붉어진다. `self` 주석을 달면
+    # `inspect.signature`가 바뀌어 shim 락의 시그니처 동일성(이주 창의 핵심
+    # 약속)이 깨진다. 7.0에서 파일째 삭제되므로 편입하지 않는다.
+    "src/hwpx/model.py",
+    "src/hwpx/objects/__init__.py",
+    # 6.0 (062-engine-surface WP-C): 반환 규약 소유 모듈 5종 — 같은 이유로
+    # 게이트 안에서 태어난다(위 WP-A 주석 참조).
+    "src/hwpx/objects/binary_item.py",
+    "src/hwpx/objects/checkbox.py",
+    "src/hwpx/objects/form_field.py",
+    "src/hwpx/objects/results.py",
+    "src/hwpx/objects/tracked.py",
+    "src/hwpx/_document/_resolve.py",
+    "src/hwpx/_document/headings.py",
+    "src/hwpx/_document/ns",
     "src/hwpx/_document/fields.py",
     "src/hwpx/_document/layout.py",
     "src/hwpx/_document/media.py",