python-hwpx 1.0__tar.gz → 1.1__tar.gz

{python-hwpx-1.0/src/python_hwpx.egg-info → python-hwpx-1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-hwpx
-Version: 1.0
+Version: 1.1
 Summary: Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음
 Author: python-hwpx Maintainers
 License: Non-Commercial License
@@ -45,13 +45,10 @@ python-hwpx는 Hancom HWPX 패키지를 분석하고 편집하기 위한 Python
 
 ### 1. 환경 준비
 
-가상 환경을 만든 뒤 PyPI에 배포된 패키지를 설치하세요.
+pip를 이용해 패키지를 설치합니다.
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install python-hwpx
+python pip install python-hwpx
 ```
 
 최신 개발 버전을 사용하거나 소스 코드를 수정하려면 편집 가능한 설치를 권장합니다.

{python-hwpx-1.0 → python-hwpx-1.1}/README.md

@@ -15,13 +15,10 @@ python-hwpx는 Hancom HWPX 패키지를 분석하고 편집하기 위한 Python
 
 ### 1. 환경 준비
 
-가상 환경을 만든 뒤 PyPI에 배포된 패키지를 설치하세요.
+pip를 이용해 패키지를 설치합니다.
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install python-hwpx
+python pip install python-hwpx
 ```
 
 최신 개발 버전을 사용하거나 소스 코드를 수정하려면 편집 가능한 설치를 권장합니다.

{python-hwpx-1.0 → python-hwpx-1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "1.0"
+version = "1.1"
 description = "Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = { text = "Non-Commercial License" }

{python-hwpx-1.0 → python-hwpx-1.1}/src/hwpx/document.py

@@ -22,6 +22,7 @@ from .oxml import (
     RunStyle,
 )
 from .package import HwpxPackage
+from .templates import blank_document_bytes
 
 _HP_NS = "http://www.hancom.co.kr/hwpml/2011/paragraph"
 _HP = f"{{{_HP_NS}}}"
@@ -46,6 +47,12 @@ class HwpxDocument:
         root = HwpxOxmlDocument.from_package(package)
         return cls(package, root)
 
+    @classmethod
+    def new(cls) -> "HwpxDocument":
+        """Return a new blank document based on the default skeleton template."""
+
+        return cls.open(blank_document_bytes())
+
     @classmethod
     def from_package(cls, package: HwpxPackage) -> "HwpxDocument":
         """Create a document backed by an existing :class:`HwpxPackage`."""

python-hwpx-1.1/src/hwpx/templates.py

@@ -0,0 +1,33 @@
+"""Embedded templates and sample payloads for HWPX documents."""
+
+from __future__ import annotations
+
+from functools import lru_cache
+from importlib import resources
+from pathlib import Path
+
+
+@lru_cache(maxsize=None)
+def blank_document_bytes() -> bytes:
+    """Return the binary payload for a minimal blank HWPX document."""
+
+    # Prefer a packaged asset when available.
+    try:
+        data_pkg = resources.files("hwpx.data")
+    except (ModuleNotFoundError, AttributeError):  # pragma: no cover - optional dependency
+        data_pkg = None
+    if data_pkg is not None:
+        skeleton = data_pkg / "Skeleton.hwpx"
+        if skeleton.is_file():  # type: ignore[call-arg]
+            with skeleton.open("rb") as stream:  # type: ignore[call-arg]
+                return stream.read()
+
+    # Fall back to the repository examples folder during development.
+    root = Path(__file__).resolve().parent.parent.parent
+    fallback = root / "examples" / "Skeleton.hwpx"
+    if fallback.is_file():
+        return fallback.read_bytes()
+
+    raise FileNotFoundError(
+        "Could not locate Skeleton.hwpx; ensure the template asset is packaged."
+    )

{python-hwpx-1.0 → python-hwpx-1.1/src/python_hwpx.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-hwpx
-Version: 1.0
+Version: 1.1
 Summary: Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음
 Author: python-hwpx Maintainers
 License: Non-Commercial License
@@ -45,13 +45,10 @@ python-hwpx는 Hancom HWPX 패키지를 분석하고 편집하기 위한 Python
 
 ### 1. 환경 준비
 
-가상 환경을 만든 뒤 PyPI에 배포된 패키지를 설치하세요.
+pip를 이용해 패키지를 설치합니다.
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install python-hwpx
+python pip install python-hwpx
 ```
 
 최신 개발 버전을 사용하거나 소스 코드를 수정하려면 편집 가능한 설치를 권장합니다.

{python-hwpx-1.0 → python-hwpx-1.1}/src/python_hwpx.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ pyproject.toml
 src/hwpx/__init__.py
 src/hwpx/document.py
 src/hwpx/package.py
+src/hwpx/templates.py
 src/hwpx/opc/package.py
 src/hwpx/oxml/__init__.py
 src/hwpx/oxml/body.py