python-hwpx 2.23.0__tar.gz → 2.24.1__tar.gz

{python_hwpx-2.23.0/src/python_hwpx.egg-info → python_hwpx-2.24.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.23.0
+Version: 2.24.1
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -20,7 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: lxml<6,>=4.9
+Requires-Dist: lxml<7,>=4.9
 Provides-Extra: visual
 Requires-Dist: pymupdf>=1.24; extra == "visual"
 Requires-Dist: pillow>=10.0; extra == "visual"
@@ -105,6 +105,7 @@ new.save_to_path("새문서.hwpx")
 ### 🔍 읽기 · 추출
 - 텍스트/HTML/Markdown 내보내기 — `export_text()` · `export_html()` · `export_markdown()`
 - **풍부한 Markdown** — `export_rich_markdown()`은 인라인 서식(`**굵게**`·`*기울임*`·`~~취소선~~`), 중첩 표(colspan/rowspan 안전), 도형 텍스트, 이미지, 각주/미주, 하이퍼링크, 제목(`#`/`##`) 자동 감지까지 보존
+- **문서 ingest 게이트웨이** — `hwpx.ingest.DocumentIngestor`가 HWPX를 감지해 rich Markdown과 섹션/표 메타데이터로 정규화
 - `TextExtractor` / `ObjectFinder` — 섹션·문단 순회, 태그·속성·XPath로 객체 탐색 (`hp:tab`은 `\t`로 보존, roundtrip 안전)
 
 ```python
@@ -201,6 +202,15 @@ pip install -e ".[dev]"
 pytest
 ```
 
+## 감사의 말
+
+아래 공개 표준·프로젝트에 빚지고 있습니다.
+
+- **[OWPML — 개방형 워드프로세서 마크업 언어 (KS X 6101)](https://www.kssn.net/search/stddetail.do?itemNo=K001010119985)** — HWPX가 기반하는 한국 산업 표준
+- **[hancom-io/hwpx-owpml-model](https://github.com/hancom-io/hwpx-owpml-model)** — OWPML 요소 구조 참조 모델 · **[neolord0/hwpxlib](https://github.com/neolord0/hwpxlib)** — 오라클 샘플 코퍼스
+- **[edwardkim/rhwp](https://github.com/edwardkim/rhwp)** — 멱등성·검증 게이트 설계 영감
+- **범정부오피스** — 공무 문서 편집 워크플로 아이디어
+
 ## License
 
 Apache License 2.0. See LICENSE and NOTICE.

{python_hwpx-2.23.0 → python_hwpx-2.24.1}/README.md

@@ -63,6 +63,7 @@ new.save_to_path("새문서.hwpx")
 ### 🔍 읽기 · 추출
 - 텍스트/HTML/Markdown 내보내기 — `export_text()` · `export_html()` · `export_markdown()`
 - **풍부한 Markdown** — `export_rich_markdown()`은 인라인 서식(`**굵게**`·`*기울임*`·`~~취소선~~`), 중첩 표(colspan/rowspan 안전), 도형 텍스트, 이미지, 각주/미주, 하이퍼링크, 제목(`#`/`##`) 자동 감지까지 보존
+- **문서 ingest 게이트웨이** — `hwpx.ingest.DocumentIngestor`가 HWPX를 감지해 rich Markdown과 섹션/표 메타데이터로 정규화
 - `TextExtractor` / `ObjectFinder` — 섹션·문단 순회, 태그·속성·XPath로 객체 탐색 (`hp:tab`은 `\t`로 보존, roundtrip 안전)
 
 ```python
@@ -159,6 +160,15 @@ pip install -e ".[dev]"
 pytest
 ```
 
+## 감사의 말
+
+아래 공개 표준·프로젝트에 빚지고 있습니다.
+
+- **[OWPML — 개방형 워드프로세서 마크업 언어 (KS X 6101)](https://www.kssn.net/search/stddetail.do?itemNo=K001010119985)** — HWPX가 기반하는 한국 산업 표준
+- **[hancom-io/hwpx-owpml-model](https://github.com/hancom-io/hwpx-owpml-model)** — OWPML 요소 구조 참조 모델 · **[neolord0/hwpxlib](https://github.com/neolord0/hwpxlib)** — 오라클 샘플 코퍼스
+- **[edwardkim/rhwp](https://github.com/edwardkim/rhwp)** — 멱등성·검증 게이트 설계 영감
+- **범정부오피스** — 공무 문서 편집 워크플로 아이디어
+
 ## License
 
 Apache License 2.0. See LICENSE and NOTICE.

{python_hwpx-2.23.0 → python_hwpx-2.24.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "2.23.0"
+version = "2.24.1"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
@@ -25,7 +25,7 @@ classifiers = [
     "Topic :: Text Processing :: Markup :: XML",
 ]
 dependencies = [
-    "lxml>=4.9,<6",
+    "lxml>=4.9,<7",
 ]
 
 [project.optional-dependencies]
@@ -100,11 +100,19 @@ testpaths = ["tests"]
 
 [tool.mypy]
 python_version = "3.10"
+# Explicit gradual-migration allowlist: transitive imports enter the gate only
+# after they are added here and made clean themselves.
+follow_imports = "skip"
 files = [
     "src/hwpx/document.py",
     "src/hwpx/oxml/document.py",
     "src/hwpx/opc/package.py",
     "src/hwpx/opc/relationships.py",
+    "src/hwpx/oxml/paragraph.py",
+    "src/hwpx/oxml/run.py",
+    "src/hwpx/oxml/table.py",
+    "src/hwpx/quality/policy.py",
+    "src/hwpx/quality/report.py",
     "src/hwpx/tools/archive_cli.py",
     "src/hwpx/tools/package_validator.py",
     "src/hwpx/tools/page_guard.py",
@@ -126,6 +134,11 @@ ignore_errors = true
 include = [
     "src/hwpx/opc/package.py",
     "src/hwpx/opc/relationships.py",
+    "src/hwpx/oxml/paragraph.py",
+    "src/hwpx/oxml/run.py",
+    "src/hwpx/oxml/table.py",
+    "src/hwpx/quality/policy.py",
+    "src/hwpx/quality/report.py",
     "src/hwpx/tools/archive_cli.py",
     "src/hwpx/tools/package_validator.py",
     "src/hwpx/tools/page_guard.py",

{python_hwpx-2.23.0 → python_hwpx-2.24.1}/src/hwpx/__init__.py

@@ -75,6 +75,16 @@ from .tools.layout_preview import (
     PreviewPage,
     render_layout_preview,
 )
+from .ingest import (
+    ConversionAttempt,
+    DocumentConverter,
+    DocumentIngestError,
+    DocumentIngestResult,
+    DocumentIngestor,
+    DocumentSourceInfo,
+    HwpxMarkdownConverter,
+    UnsupportedDocumentFormat,
+)
 from .patch import (
     BytePreservingPatchResult,
     ParagraphTextPatch,
@@ -123,8 +133,14 @@ __all__ = [
     "DEFAULT_STYLE_PRESET",
     "DOCUMENT_PLAN_SCHEMA_VERSION",
     "get_document_plan_schema",
+    "ConversionAttempt",
     "DocumentBlock",
+    "DocumentConverter",
+    "DocumentIngestError",
+    "DocumentIngestResult",
+    "DocumentIngestor",
     "DocumentPlan",
+    "DocumentSourceInfo",
     "DocumentStylePreset",
     "EditorOpenSafetyReport",
     "ParagraphInfo",
@@ -141,6 +157,7 @@ __all__ = [
     "TEMPLATE_FORMFIT_PLAN_SCHEMA_VERSION",
     "TextExtractor",
     "FoundElement",
+    "HwpxMarkdownConverter",
     "ObjectFinder",
     "OFFICIAL_DOCUMENT_STYLE_REPORT_VERSION",
     "DOC_DIFF_REPORT_VERSION",
@@ -150,6 +167,7 @@ __all__ = [
     "STYLE_PROFILE_SCHEMA_VERSION",
     "TEMPLATE_REGISTRY_SCHEMA_VERSION",
     "TABLE_COMPUTE_REPORT_VERSION",
+    "UnsupportedDocumentFormat",
     "apply_style_profile_to_plan",
     "build_comparison_table_plan",
     "build_image_grid",