python-hwpx 3.3.0__tar.gz → 3.4.1__tar.gz

{python_hwpx-3.3.0/src/python_hwpx.egg-info → python_hwpx-3.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 3.3.0
+Version: 3.4.1
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -70,13 +70,29 @@ Dynamic: license-file
 `hwpx-mcp-server`와 `hwpx-plugin`은 같은 프로젝트가 직접 유지보수하는 first-party 연동 구성요소입니다.
 “first-party”는 프로젝트 유지보수 관계를 뜻하며, 한컴 또는 제3자의 공식 인증을 뜻하지 않습니다.
 
-현재 PyPI 공개 릴리스는 `python-hwpx 3.3.0`입니다. 일반
+현재 PyPI 공개 릴리스는 `python-hwpx 3.4.1`입니다. 일반
 `pip install python-hwpx`로 이 릴리스를 설치할 수 있습니다.
 현재 패키지 분류는 `Development Status :: 3 - Alpha`입니다. 이 분류는 API와 제품의
 성숙도를 나타내며, 공개 버전이나 플러그인의 최소 호환 버전을 대신하지 않습니다.
 
 ---
 
+## 실측으로 말합니다 — Published Corpus
+
+이 스택의 산출물은 주장 대신 **실제 한컴오피스 전수 측정**으로 검증됩니다
+(동결 코퍼스 N=497, 2026-07-19, 상세·주의사항은
+[실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)):
+
+- **한컴 오픈 수용률 100%** (476/476 all-pass, 하한 ≥99.4%) · 파싱 96.2%
+- **미수정 영역 바이트 보존 100%** (497/497, patch 경로) · **개인정보 0-leak**
+- 렌더 검증 416건 + 정직 버킷(변경추적 문서의 PDF export는 한컴 자체가 거부 — 실측 한계로 발행)
+- 양식 채움 차등은 wild 공개 양식에서 49.2% — **낮은 숫자도 그대로 발행**하고 잔여 과제로 명기합니다
+
+> 이 숫자들은 *생성물 수용률* 축입니다(우리가 만든 파일을 실제 한컴이 받아들이는가).
+> 문서 *파싱 recall*과는 다른 축이므로 파서 프로젝트 수치와 병치 비교하지 마세요.
+
+---
+
 ## 왜 python-hwpx인가
 
 - **코어 편집에 한컴오피스 설치 불필요** — HWPX는 ZIP+XML(OWPML/OPC) 구조라, 순수 파이썬으로 Windows·macOS·Linux·CI 어디서나 읽고 씁니다.

{python_hwpx-3.3.0 → python_hwpx-3.4.1}/README.md

@@ -25,13 +25,29 @@
 `hwpx-mcp-server`와 `hwpx-plugin`은 같은 프로젝트가 직접 유지보수하는 first-party 연동 구성요소입니다.
 “first-party”는 프로젝트 유지보수 관계를 뜻하며, 한컴 또는 제3자의 공식 인증을 뜻하지 않습니다.
 
-현재 PyPI 공개 릴리스는 `python-hwpx 3.3.0`입니다. 일반
+현재 PyPI 공개 릴리스는 `python-hwpx 3.4.1`입니다. 일반
 `pip install python-hwpx`로 이 릴리스를 설치할 수 있습니다.
 현재 패키지 분류는 `Development Status :: 3 - Alpha`입니다. 이 분류는 API와 제품의
 성숙도를 나타내며, 공개 버전이나 플러그인의 최소 호환 버전을 대신하지 않습니다.
 
 ---
 
+## 실측으로 말합니다 — Published Corpus
+
+이 스택의 산출물은 주장 대신 **실제 한컴오피스 전수 측정**으로 검증됩니다
+(동결 코퍼스 N=497, 2026-07-19, 상세·주의사항은
+[실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)):
+
+- **한컴 오픈 수용률 100%** (476/476 all-pass, 하한 ≥99.4%) · 파싱 96.2%
+- **미수정 영역 바이트 보존 100%** (497/497, patch 경로) · **개인정보 0-leak**
+- 렌더 검증 416건 + 정직 버킷(변경추적 문서의 PDF export는 한컴 자체가 거부 — 실측 한계로 발행)
+- 양식 채움 차등은 wild 공개 양식에서 49.2% — **낮은 숫자도 그대로 발행**하고 잔여 과제로 명기합니다
+
+> 이 숫자들은 *생성물 수용률* 축입니다(우리가 만든 파일을 실제 한컴이 받아들이는가).
+> 문서 *파싱 recall*과는 다른 축이므로 파서 프로젝트 수치와 병치 비교하지 마세요.
+
+---
+
 ## 왜 python-hwpx인가
 
 - **코어 편집에 한컴오피스 설치 불필요** — HWPX는 ZIP+XML(OWPML/OPC) 구조라, 순수 파이썬으로 Windows·macOS·Linux·CI 어디서나 읽고 씁니다.

{python_hwpx-3.3.0 → python_hwpx-3.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "3.3.0"
+version = "3.4.1"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
@@ -109,6 +109,14 @@ python_version = "3.10"
 follow_imports = "skip"
 files = [
     "src/hwpx/document.py",
+    "src/hwpx/_document/_units.py",
+    "src/hwpx/_document/fields.py",
+    "src/hwpx/_document/layout.py",
+    "src/hwpx/_document/media.py",
+    "src/hwpx/_document/memos.py",
+    "src/hwpx/_document/persistence.py",
+    "src/hwpx/_document/shapes.py",
+    "src/hwpx/_document/tracked.py",
     "src/hwpx/agent/commands.py",
     "src/hwpx/agent/document.py",
     "src/hwpx/agent/story.py",
@@ -148,6 +156,14 @@ ignore_missing_imports = true
 # both central facades and every extracted/touched runtime owner to the gate.
 include = [
     "src/hwpx/document.py",
+    "src/hwpx/_document/_units.py",
+    "src/hwpx/_document/fields.py",
+    "src/hwpx/_document/layout.py",
+    "src/hwpx/_document/media.py",
+    "src/hwpx/_document/memos.py",
+    "src/hwpx/_document/persistence.py",
+    "src/hwpx/_document/shapes.py",
+    "src/hwpx/_document/tracked.py",
     "src/hwpx/agent/commands.py",
     "src/hwpx/agent/document.py",
     "src/hwpx/agent/story.py",

python_hwpx-3.4.1/src/hwpx/_document/__init__.py

@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: Apache-2.0
+"""Domain owners behind the HwpxDocument facade (S-084)."""

python_hwpx-3.4.1/src/hwpx/_document/_units.py

@@ -0,0 +1,16 @@
+# SPDX-License-Identifier: Apache-2.0
+"""Shared HWPUNIT conversion helpers for the HwpxDocument owner modules (S-084)."""
+
+from __future__ import annotations
+
+
+_HWP_UNITS_PER_MM = 7200 / 25.4
+_HWP_UNITS_PER_PT = 100
+
+
+def _mm_to_hwp_units(value: float) -> int:
+    return round(value * _HWP_UNITS_PER_MM)
+
+
+def _pt_to_hwp_units(value: float) -> int:
+    return round(value * _HWP_UNITS_PER_PT)