python-hwpx 2.9.1__tar.gz → 2.10.0__tar.gz

python_hwpx-2.10.0/NOTICE

@@ -0,0 +1,42 @@
+python-hwpx
+Copyright 2025-2026 airmang
+
+This product includes software developed by airmang.
+Licensed under the Apache License, Version 2.0.
+
+Clean-room implementation references:
+
+The HWPX repair and recovery tools include behavior ideas independently
+reimplemented from public references, without copying source code:
+
+- sakada3/hwp-ops (Apache-2.0): repair-repack behavior for placing the
+  mimetype entry first, storing it uncompressed, and running ZIP integrity
+  checks.
+- chrisryugj/kordoc (MIT): broken HWPX ZIP recovery behavior using Local File
+  Header scanning when the central directory is damaged.
+- chrisryugj/kordoc (MIT): HWPX form-fill behavior ideas for preserving
+  text-node and run structure, including split text-range replacement and empty
+  run handling.
+- sakada3/hwp-ops (Apache-2.0): split-run placeholder scan/fill behavior
+  ideas, charPrIDRef heterogeneity warning, and touched-paragraph layout-cache
+  invalidation.
+
+These form-fill references were used as behavior evidence only. The
+implementation is a clean-room Python implementation; no source code was
+copied, translated, vendored, or linked.
+
+## Test fixtures: hwpxlib sample corpus
+
+tests/fixtures/hwpxlib_corpus/ contains .hwpx sample files vendored from
+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.
+
+────────────────────────────────────────
+DISCLAIMER — HWPX Format
+
+"HWPX" is the document format specified and trademarked by
+Hancom Inc. (한글과컴퓨터). This project is an independent,
+unofficial implementation and is not affiliated with, endorsed by,
+or sponsored by Hancom Inc.
+────────────────────────────────────────

{python_hwpx-2.9.1/src/python_hwpx.egg-info → python_hwpx-2.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.9.1
+Version: 2.10.0
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -177,6 +177,13 @@ document.save_to_path("새문서.hwpx")
 > | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 > | **방식** | 직접 XML 파싱 | COM 자동화 | OLE 파싱 |
 
+## HWPX plugin usage
+
+The per-host bundles in the `hwpx-plugins` repository consume `python-hwpx` through
+`hwpx-mcp-server` and the local quickcheck scripts. During local development, set
+`PYTHON_HWPX_REPO=/absolute/path/to/python-hwpx` so the plugin launcher uses this checkout as an
+editable dependency.
+
 ## 🌍 크로스 플랫폼 지원
 
 HWPX 파일은 **ZIP + XML** 구조이므로, 한/글 프로그램 없이 Python만으로 읽고 편집하는 워크플로를 구성할 수 있습니다.

{python_hwpx-2.9.1 → python_hwpx-2.10.0}/README.md

@@ -141,6 +141,13 @@ document.save_to_path("새문서.hwpx")
 > | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 > | **방식** | 직접 XML 파싱 | COM 자동화 | OLE 파싱 |
 
+## HWPX plugin usage
+
+The per-host bundles in the `hwpx-plugins` repository consume `python-hwpx` through
+`hwpx-mcp-server` and the local quickcheck scripts. During local development, set
+`PYTHON_HWPX_REPO=/absolute/path/to/python-hwpx` so the plugin launcher uses this checkout as an
+editable dependency.
+
 ## 🌍 크로스 플랫폼 지원
 
 HWPX 파일은 **ZIP + XML** 구조이므로, 한/글 프로그램 없이 Python만으로 읽고 편집하는 워크플로를 구성할 수 있습니다.

{python_hwpx-2.9.1 → python_hwpx-2.10.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "2.9.1"
+version = "2.10.0"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
@@ -57,6 +57,7 @@ hwpx-validate-package = "hwpx.tools.package_validator:main"
 hwpx-page-guard = "hwpx.tools.page_guard:main"
 hwpx-analyze-template = "hwpx.tools.template_analyzer:main"
 hwpx-text-extract = "hwpx.tools.text_extract_cli:main"
+hwpx-repair = "hwpx.tools.repair:main"
 
 [tool.setuptools]
 package-dir = { "" = "src" }

python_hwpx-2.10.0/src/hwpx/__init__.py

@@ -0,0 +1,79 @@
+# SPDX-License-Identifier: Apache-2.0
+"""High-level utilities for working with HWPX documents."""
+
+from importlib.metadata import PackageNotFoundError, version as _metadata_version
+
+
+def _resolve_version() -> str:
+    """패키지 메타데이터에서 현재 배포 버전을 조회합니다."""
+    try:
+        return _metadata_version("python-hwpx")
+    except PackageNotFoundError:
+        return "0+unknown"
+
+def __getattr__(name: str) -> object:
+    """Resolve dynamic module attributes."""
+
+    if name == "__version__":
+        return _resolve_version()
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+from .tools.text_extractor import (
+    DEFAULT_NAMESPACES,
+    ParagraphInfo,
+    SectionInfo,
+    TextExtractor,
+)
+from .tools.object_finder import FoundElement, ObjectFinder
+from .document import HwpxDocument
+from .package import HwpxPackage
+from .authoring import (
+    AUTHORING_REPORT_VERSION,
+    DEFAULT_STYLE_PRESET,
+    DOCUMENT_PLAN_SCHEMA_VERSION,
+    DocumentBlock,
+    DocumentPlan,
+    DocumentStylePreset,
+    PlanValidationIssue,
+    PlanValidationReport,
+    create_document_from_plan,
+    inspect_document_authoring_quality,
+    inspect_operating_plan_quality,
+    normalize_document_plan,
+    validate_document_plan,
+)
+from .template_formfit import (
+    TEMPLATE_FORMFIT_BASELINE_SCHEMA_VERSION,
+    TEMPLATE_FORMFIT_PLAN_SCHEMA_VERSION,
+    analyze_template_formfit,
+    apply_template_formfit,
+)
+
+__all__ = [
+    "__version__",
+    "AUTHORING_REPORT_VERSION",
+    "DEFAULT_NAMESPACES",
+    "DEFAULT_STYLE_PRESET",
+    "DOCUMENT_PLAN_SCHEMA_VERSION",
+    "DocumentBlock",
+    "DocumentPlan",
+    "DocumentStylePreset",
+    "ParagraphInfo",
+    "PlanValidationReport",
+    "SectionInfo",
+    "TEMPLATE_FORMFIT_BASELINE_SCHEMA_VERSION",
+    "TEMPLATE_FORMFIT_PLAN_SCHEMA_VERSION",
+    "TextExtractor",
+    "FoundElement",
+    "ObjectFinder",
+    "PlanValidationIssue",
+    "HwpxDocument",
+    "HwpxPackage",
+    "create_document_from_plan",
+    "analyze_template_formfit",
+    "apply_template_formfit",
+    "inspect_document_authoring_quality",
+    "inspect_operating_plan_quality",
+    "normalize_document_plan",
+    "validate_document_plan",
+]