python-hwpx 2.29.1__tar.gz → 3.0.0__tar.gz

{python_hwpx-2.29.1/src/python_hwpx.egg-info → python_hwpx-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.29.1
+Version: 3.0.0
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -37,6 +37,7 @@ Requires-Dist: numpy>=1.26; extra == "test"
 Requires-Dist: pillow>=10.0; extra == "test"
 Requires-Dist: pytest>=7.4; extra == "test"
 Requires-Dist: pytest-cov>=5.0; extra == "test"
+Requires-Dist: ruff>=0.12; extra == "test"
 Provides-Extra: typecheck
 Requires-Dist: mypy>=1.10; extra == "typecheck"
 Requires-Dist: pyright>=1.1.390; extra == "typecheck"
@@ -219,7 +220,7 @@ Apache License 2.0. See LICENSE and NOTICE.
 
 ## Maintainer
 
-Primary maintainer/contact: **고규현** — 광교고등학교 정보·컴퓨터 교사
+Primary maintainer/contact: **Kohkyuhyun** ([@airmang](https://github.com/airmang))
 
 - ✉️ [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
 - 🐙 [@airmang](https://github.com/airmang)

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/README.md

@@ -175,7 +175,7 @@ Apache License 2.0. See LICENSE and NOTICE.
 
 ## Maintainer
 
-Primary maintainer/contact: **고규현** — 광교고등학교 정보·컴퓨터 교사
+Primary maintainer/contact: **Kohkyuhyun** ([@airmang](https://github.com/airmang))
 
 - ✉️ [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
 - 🐙 [@airmang](https://github.com/airmang)

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "2.29.1"
+version = "3.0.0"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
@@ -49,6 +49,7 @@ test = [
     "pillow>=10.0",
     "pytest>=7.4",
     "pytest-cov>=5.0",
+    "ruff>=0.12",
 ]
 typecheck = [
     "mypy>=1.10",

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/agent/blueprint/dump.py

@@ -16,7 +16,6 @@ from ..document import HwpxAgentDocument, NodeRecord
 from ..model import AGENT_CATALOG_SCHEMA, NODE_KINDS, AgentContractError
 from .bundle import (
     ALLOWED_MEDIA_TYPES,
-    BlueprintBundle,
     build_blueprint_bundle,
     read_blueprint_bundle,
     write_blueprint_bundle,

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/agent/blueprint/native.py

@@ -11,7 +11,6 @@ from dataclasses import dataclass
 from typing import Any
 
 from hwpx.document import HwpxDocument
-from hwpx.oxml import HwpxOxmlTable
 from hwpx.oxml.namespaces import HH, HP
 
 from ..commands import _add, _insert_direct_child, _insert_inline, _remove_inline_element, _table_caption

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/benchmark/blind_eval.py

@@ -12,7 +12,7 @@ import json
 import math
 from collections import Counter, defaultdict
 from pathlib import Path
-from typing import Any, Mapping, Sequence
+from typing import Any, Mapping
 
 BENCHMARK_SCHEMA = "hwpx.blind-real-work-eval/v1"
 RESULT_SCHEMA = "hwpx.blind-real-work-eval-result/v1"

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/design/profiles/official_notice/profile.json

@@ -21,5 +21,5 @@
   },
   "char_pr_count": 65,
   "style_coverage_threshold": 0.98,
-  "source_basename": "경기도교육청 미래교육담당관_교육용 상용클라우드서비스 이용 안내.hwpx"
-}
+  "source_basename": "synthetic_official_notice_source.hwpx"
+}

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/document.py

@@ -5,19 +5,16 @@ from __future__ import annotations
 
 import xml.etree.ElementTree as ET
 import io
-import os
 import re
-import tempfile
 import warnings
 from datetime import datetime
 import logging
 import uuid
 
 from os import PathLike
-from pathlib import Path, PurePosixPath
+from pathlib import PurePosixPath
 from typing import TYPE_CHECKING, Any, BinaryIO, Iterator, Mapping, Sequence, overload
 
-from lxml import etree
 
 from .oxml import (
     Bullet,
@@ -65,6 +62,9 @@ _HWP_UNITS_PER_PT = 100
 logger = logging.getLogger(__name__)
 
 if TYPE_CHECKING:
+    from .form_fit.policy import FitPolicy
+    from .form_fit.report import FitResult
+    from .tools.validator import ValidationReport
     from .tools.table_navigation import TableFillResult, TableLabelSearchResult, TableMapResult
 
 

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/evalplan_fill.py

@@ -18,7 +18,7 @@ from __future__ import annotations
 
 import re
 from dataclasses import dataclass, field
-from typing import Any
+from typing import Any, Sequence
 
 _CIRCLED = "①②③④⑤⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮"
 
@@ -327,7 +327,7 @@ def _pick_achieve_rate(tabs, want_bands: int | None) -> int | None:
 
 def _regular_exam_cols(table) -> list[int]:
     """Logical column indices of the 정기시험 span in a 반영비율 table header."""
-    from .table_patch import build_grid, _direct_cells, _text_of
+    from .table_patch import build_grid, _text_of
     tb = table.bytes
     grid, rep = build_grid(tb)
     cols: list[int] = []
@@ -1084,7 +1084,7 @@ def fill_rubrics(data: bytes, content: EvalPlanContent) -> tuple[bytes, dict[str
     cells (title / points / 성취기준 / A~E / 수행과제 / 평가요소 leaders / 기본점수 배점),
     reshapes+fills the 수행수준 채점기준 ladder, and rewrites each rubric's ordinal
     heading paragraph (가./나./다. + sample project title) to the review 영역명."""
-    from .table_patch import apply_table_ops, fill_cells, _text_of, _all_paragraph_spans
+    from .table_patch import apply_table_ops, fill_cells, _all_paragraph_spans
 
     report: dict[str, Any] = {"rubrics": len(content.rubrics), "filled": 0, "skipped": []}
     levels = content.levels
@@ -1122,7 +1122,6 @@ def fill_rubrics(data: bytes, content: EvalPlanContent) -> tuple[bytes, dict[str
         if hdr is None or base is None:
             report["skipped"].append(f"rubric {i}: could not bound item block")
             continue
-        item_rows = base - (hdr + 1)          # blank example block height (7)
         first_item = hdr + 1
         todel = list(range(first_item + n, base))   # keep n, drop the surplus
         if todel:
@@ -1471,7 +1470,6 @@ def fill_ratio(data: bytes, content: EvalPlanContent) -> tuple[bytes, dict[str,
         return data, report
     _sp, tb, grid, rep = _grid_of(data, ti)
     label_col, area_cols, total_col = _ratio_columns(tb, grid, rep)
-    areas = _area_names(content)
     if not area_cols:
         report["skipped"].append(f"no area columns detected (label_col={label_col}, total_col={total_col})")
         return data, report

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/form_fit/seal.py

@@ -32,7 +32,7 @@ point is exactly ``100`` HWPUNIT (``7200 / 72``).
 from __future__ import annotations
 
 import math
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 from typing import Any, Sequence
 
 from .wordbox import Rect, WordBox
@@ -219,8 +219,7 @@ def check_seal_placement(
     offset = math.hypot(scx - acx, scy - acy)
     centered = offset <= tol_pt
 
-    # Glyphs the seal sits on top of, excluding the anchor's own line (intended).
-    anchor_line = set(_norm(anchor.line_text))  # cheap line-membership proxy by text
+    # Glyphs the seal sits on top of, excluding the anchor's own baseline.
     anchor_cy = anchor.center[1]
     occluded = 0
     for g in boxes:

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/formfill_quality.py

@@ -36,7 +36,6 @@ from pathlib import Path
 from typing import Any, Sequence
 
 from .table_patch import (
-    _direct_cells,
     _iter_table_spans,
     _read_source_bytes,
     _sections,

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/oxml/__init__.py

@@ -135,11 +135,13 @@ __all__ = [
     "HwpxOxmlMasterPage",
     "HwpxOxmlMemo",
     "HwpxOxmlMemoGroup",
+    "HwpxOxmlNote",
     "HwpxOxmlParagraph",
     "HwpxOxmlRun",
     "HwpxOxmlSection",
     "HwpxOxmlSectionHeaderFooter",
     "HwpxOxmlSectionProperties",
+    "HwpxOxmlShape",
     "HwpxOxmlTable",
     "HwpxOxmlTableCell",
     "HwpxTableGridPosition",

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/oxml/_document_impl.py

@@ -7,7 +7,7 @@ import logging
 import re as _re
 from copy import deepcopy
 from dataclasses import dataclass
-from typing import Any, Callable, Iterable, Iterator, Mapping, Optional, Sequence, TypeVar
+from typing import TYPE_CHECKING, Any, Callable, Iterable, Iterator, Mapping, Optional, Sequence, TypeVar
 from uuid import uuid4
 import xml.etree.ElementTree as ET
 
@@ -52,6 +52,11 @@ from .namespaces import (
 )
 from .utils import parse_int
 
+if TYPE_CHECKING:
+    from hwpx.form_fit.policy import FitPolicy
+    from hwpx.form_fit.report import FitResult
+    from hwpx.opc.package import HwpxPackage
+
 register_owpml_namespaces(ET.register_namespace)
 logger = logging.getLogger(__name__)
 

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/oxml/body.py

@@ -7,7 +7,7 @@ from typing import Dict, List, Optional, Union
 
 from lxml import etree
 
-from .common import GenericElement, parse_generic_element
+from .common import GenericElement
 from .namespaces import HP
 from .utils import local_name, parse_bool, parse_int
 

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/oxml/document.py

@@ -13,7 +13,6 @@ from types import ModuleType
 
 from . import _document_impl as _impl
 from ._document_impl import *  # noqa: F401,F403
-from ._document_impl import _memo_id, _object_id, _paragraph_id
 
 __all__ = [name for name in dir(_impl) if not name.startswith("_")]
 

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/oxml/header.py

@@ -1480,7 +1480,7 @@ def track_change_to_xml(change: TrackChange) -> etree._Element:
     _set_optional_int_attr(attributes, "id", change.id)
     if change.raw_id is not None and change.id is None:
         attributes["id"] = change.raw_id
-    return etree.Element(f"{{http://www.hancom.co.kr/hwpml/2011/head}}trackChange", attributes)
+    return etree.Element("{http://www.hancom.co.kr/hwpml/2011/head}trackChange", attributes)
 
 
 def track_change_author_to_xml(author: TrackChangeAuthor) -> etree._Element:
@@ -1496,7 +1496,7 @@ def track_change_author_to_xml(author: TrackChangeAuthor) -> etree._Element:
         attributes["id"] = author.raw_id
     _set_optional_str_attr(attributes, "color", author.color)
     return etree.Element(
-        f"{{http://www.hancom.co.kr/hwpml/2011/head}}trackChangeAuthor",
+        "{http://www.hancom.co.kr/hwpml/2011/head}trackChangeAuthor",
         attributes,
     )
 

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/table_patch.py

@@ -840,6 +840,25 @@ def _collapse_empty_rows(table: str) -> str:
     return _rebuild(prefix, rows, suffix, rowcnt=rowcnt)
 
 
+def _physical_row_height(rows: Sequence[str], row: int) -> int | None:
+    """Return the exact height of a physical row when direct cells expose it.
+
+    A physical row can contain several ``rowSpan==1`` cells with different
+    ``cellSz`` heights.  Hancom uses the tallest direct cell as the row height;
+    shorter values can belong to sparse/covered-looking cells.  ``None`` means
+    the row is covered entirely by vertical merges and remains underivable.
+    """
+    heights: list[int] = []
+    for physical_row in rows:
+        for tc in _S_TC.findall(physical_row):
+            ra = _si(tc, "cellAddr", "rowAddr")
+            rs = _si(tc, "cellSpan", "rowSpan") or 1
+            height = _si(tc, "cellSz", "height")
+            if ra == row and rs == 1 and height is not None and height > 0:
+                heights.append(height)
+    return max(heights) if heights else None
+
+
 def _delete_rows(table: str, del_rows: Iterable[int]) -> str:
     """Delete physical rows by index, reconciling rowAddr/rowSpan and covering
     cells' height."""
@@ -849,6 +868,7 @@ def _delete_rows(table: str, del_rows: Iterable[int]) -> str:
     for empty in del_rows:
         if empty >= len(rows):
             raise TableStructureError(f"row index {empty} out of range")
+        exact_height = _physical_row_height(rows, empty)
         heights = []
         for r in rows:
             for tc in _S_TC.findall(r):
@@ -857,7 +877,9 @@ def _delete_rows(table: str, del_rows: Iterable[int]) -> str:
                     h = _si(tc, "cellSz", "height")
                     if h:
                         heights.append(h // rs)
-        drop_h = min(heights) if heights else 0
+        # Prefer the exact physical-row height.  Fully merged rows expose no
+        # rowSpan==1 cell, so preserve the previous conservative estimate there.
+        drop_h = exact_height if exact_height is not None else (min(heights) if heights else 0)
 
         def fix(tc: str):
             ra, rs = _si(tc, "cellAddr", "rowAddr"), _si(tc, "cellSpan", "rowSpan") or 1

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/tools/fuzz/runner.py

@@ -8,7 +8,6 @@ import logging
 import shutil
 import tempfile
 from contextlib import contextmanager
-from copy import deepcopy
 from dataclasses import dataclass
 from pathlib import Path
 from random import Random

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/tools/toc_fidelity.py

@@ -24,7 +24,7 @@ from __future__ import annotations
 import re
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Any, Sequence
+from typing import Any
 
 from hwpx.document import HwpxDocument
 

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/visual/detectors.py

@@ -14,7 +14,7 @@ gate on :func:`imaging_available` and degrade otherwise.
 """
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:  # pragma: no cover - typing only
     from PIL import Image
@@ -88,7 +88,6 @@ def new_ink_ratio_outside_mask(before: "Image.Image", after: "Image.Image", rect
     output but not the original, in a region the edit was not allowed to paint.
     """
 
-    import numpy as np
 
     before, after = _match_size(before, after)
     new_ink = _ink_mask(after) & ~_ink_mask(before)

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/hwpx/visual/hancom_worker.py

@@ -5,7 +5,6 @@ from __future__ import annotations
 
 import hashlib
 import json
-import os
 import shutil
 import subprocess
 import tempfile

{python_hwpx-2.29.1 → python_hwpx-3.0.0/src/python_hwpx.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.29.1
+Version: 3.0.0
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -37,6 +37,7 @@ Requires-Dist: numpy>=1.26; extra == "test"
 Requires-Dist: pillow>=10.0; extra == "test"
 Requires-Dist: pytest>=7.4; extra == "test"
 Requires-Dist: pytest-cov>=5.0; extra == "test"
+Requires-Dist: ruff>=0.12; extra == "test"
 Provides-Extra: typecheck
 Requires-Dist: mypy>=1.10; extra == "typecheck"
 Requires-Dist: pyright>=1.1.390; extra == "typecheck"
@@ -219,7 +220,7 @@ Apache License 2.0. See LICENSE and NOTICE.
 
 ## Maintainer
 
-Primary maintainer/contact: **고규현** — 광교고등학교 정보·컴퓨터 교사
+Primary maintainer/contact: **Kohkyuhyun** ([@airmang](https://github.com/airmang))
 
 - ✉️ [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
 - 🐙 [@airmang](https://github.com/airmang)

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/python_hwpx.egg-info/SOURCES.txt

@@ -123,21 +123,6 @@ src/hwpx/oxml/section.py
 src/hwpx/oxml/simple_parts.py
 src/hwpx/oxml/table.py
 src/hwpx/oxml/utils.py
-src/hwpx/practice/__init__.py
-src/hwpx/practice/aggregate.py
-src/hwpx/practice/campaign.py
-src/hwpx/practice/domain.py
-src/hwpx/practice/dossier.py
-src/hwpx/practice/evaluator.py
-src/hwpx/practice/forge.py
-src/hwpx/practice/intake.py
-src/hwpx/practice/lineage.py
-src/hwpx/practice/mutations.py
-src/hwpx/practice/registry.py
-src/hwpx/practice/run.py
-src/hwpx/practice/sanitize.py
-src/hwpx/practice/scenario.py
-src/hwpx/practice/split.py
 src/hwpx/presets/__init__.py
 src/hwpx/presets/proposal.py
 src/hwpx/quality/__init__.py
@@ -299,18 +284,8 @@ tests/test_paragraph_section_management.py
 tests/test_pii.py
 tests/test_pii_structural.py
 tests/test_pii_wiring.py
-tests/test_practice_campaign_aggregate.py
-tests/test_practice_contracts.py
-tests/test_practice_domain_evaluator.py
-tests/test_practice_evaluator.py
-tests/test_practice_intake.py
-tests/test_practice_run_contracts.py
-tests/test_practice_sanitize.py
-tests/test_practice_scenario_forge.py
-tests/test_practice_scenario_pack.py
-tests/test_practice_source_integrity.py
-tests/test_practice_split.py
 tests/test_proposal_preset.py
+tests/test_public_runtime_boundary.py
 tests/test_question_split_detector.py
 tests/test_read_fidelity.py
 tests/test_recover_broken_zip.py

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/src/python_hwpx.egg-info/requires.txt

@@ -11,6 +11,7 @@ numpy>=1.26
 pillow>=10.0
 pytest>=7.4
 pytest-cov>=5.0
+ruff>=0.12
 
 [typecheck]
 mypy>=1.10

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_agent_blueprint_contracts.py

@@ -132,7 +132,7 @@ def test_manifest_rejects_hash_mismatch_and_absolute_private_label() -> None:
     with pytest.raises(AgentContractError):
         validate_blueprint_manifest(manifest)
     manifest = _manifest()
-    manifest["source"]["label"] = "/Users/private/source.hwpx"
+    manifest["source"]["label"] = "/workspace/private/source.hwpx"
     manifest = with_blueprint_hash(manifest)
     with pytest.raises(AgentContractError):
         validate_blueprint_manifest(manifest)

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_body_patch.py

@@ -211,7 +211,6 @@ def test_strip_runs_by_color_reaches_cells(work, tmp_path):
 
 def test_recolor_runs_exact_hex(work, tmp_path):
     """정확 hex 매칭으로 재색 — 계열 다른 디자인색은 불변."""
-    import hwpx.guidance_scan as gs
     from hwpx.body_patch import recolor_runs_by_color
     from hwpx.fill_residue import _scan_paragraphs
     out = tmp_path / "out.hwpx"

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_builder_core.py

@@ -197,7 +197,7 @@ def test_document_ensure_run_style_supports_rich_char_properties() -> None:
     }
 
 
-def test_builder_lowers_rich_runs_and_reopen_preserves_style(tmp_path) -> None:
+def test_builder_lowers_korean_rich_run_and_reopen_preserves_style(tmp_path) -> None:
     from hwpx.builder import Document, Paragraph, Run, Section
 
     path = tmp_path / "builder-rich-run.hwpx"
@@ -280,7 +280,7 @@ def test_ensure_run_style_supports_rich_char_properties() -> None:
     assert style.child_attributes["strikeout"]["shape"] == "SOLID"
 
 
-def test_builder_lowers_rich_runs_and_reopen_preserves_style(tmp_path) -> None:
+def test_builder_lowers_mixed_rich_runs_and_reopen_preserves_style(tmp_path) -> None:
     from hwpx.builder import Document, Paragraph, Run, Section
 
     path = tmp_path / "builder-rich-runs.hwpx"
@@ -571,7 +571,7 @@ def test_table_set_column_widths_applies_weighted_cell_sizes() -> None:
     assert [table.cell(1, col_index).width for col_index in range(3)] == widths
 
 
-def test_builder_table_integrates_widths_shading_and_merges(tmp_path) -> None:
+def test_builder_table_integrates_vertical_merge(tmp_path) -> None:
     from hwpx.builder import Document, Section, Table
 
     path = tmp_path / "builder-table-integrated.hwpx"
@@ -624,7 +624,7 @@ def test_table_set_column_widths_updates_cell_sizes(tmp_path) -> None:
     assert [reopened_table.cell(1, col).width for col in range(3)] == [7200, 10800, 3600]
 
 
-def test_builder_table_integrates_widths_shading_and_merges(tmp_path) -> None:
+def test_builder_table_integrates_header_merge(tmp_path) -> None:
     from hwpx.builder import Document, Section, Table
 
     path = tmp_path / "builder-table-integrated.hwpx"

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_conformance.py

@@ -8,7 +8,6 @@ The real-Hancom verification is the opt-in oracle run, not these tests.
 """
 from __future__ import annotations
 
-import io
 import json
 from pathlib import Path
 
@@ -16,8 +15,6 @@ import pytest
 
 from hwpx import HwpxDocument
 from hwpx.conformance import (
-    Badge,
-    BadgeThresholds,
     CaseResult,
     ConformanceCase,
     ConformanceCorpus,

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_corpus_read_fidelity.py

@@ -8,7 +8,6 @@ from __future__ import annotations
 
 from pathlib import Path
 
-import pytest
 
 from hwpx.tools.read_fidelity import corpus_fidelity
 

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_coverage_promotion.py

@@ -9,7 +9,6 @@ from typing import Any
 
 from lxml import etree
 
-from hwpx.document import HwpxDocument
 from hwpx.oxml import HwpxOxmlSection, parse_section_xml
 from hwpx.oxml import GenericElement
 from hwpx.oxml.body import (

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_design_builder.py

@@ -194,12 +194,25 @@ def test_compose_returns_not_ok_when_open_safety_raises(tmp_path, monkeypatch):
 # --------------------------------------------------------------------------- #
 # Privacy: no residual source PII in committed templates or generated docs.
 # --------------------------------------------------------------------------- #
-_PII_NEEDLES = [
-    "홍옥수", "csteacher", "bluewave", "shkimde", "옥지현", "keris", "kokyu",
-    "광교", "매원", "경기도교육청", "학교공간혁신", "상용클라우드",
+_PUBLIC_PRIVACY_SENTINELS = [
+    "source-author@example.invalid",
+    "private-origin-user",
+    "source-institution.example",
+    "source-location.example",
+    "source-project-code",
 ]
 
 
+def _privacy_needles() -> list[str]:
+    """Return synthetic public sentinels plus an optional private-CI denylist."""
+    private = [
+        value.strip().lower()
+        for value in os.environ.get("HWPX_PRIVATE_PII_NEEDLES", "").split(",")
+        if value.strip()
+    ]
+    return _PUBLIC_PRIVACY_SENTINELS + private
+
+
 def _text_blob(data: bytes) -> str:
     import zipfile
 
@@ -213,13 +226,19 @@ def _text_blob(data: bytes) -> str:
 
 @pytest.mark.parametrize("pid", PROFILES)
 def test_profile_and_output_carry_no_source_pii(pid):
+    needles = _privacy_needles()
     prof = load_profile(pid)
     blob = _text_blob(prof.template_bytes)
-    assert not [n for n in _PII_NEEDLES if n in blob], pid
+    assert not [n for n in needles if n in blob], pid
     data, res = compose_bytes(_plan(pid))
     assert res.ok
     out_blob = _text_blob(data)
-    assert not [n for n in _PII_NEEDLES if n in out_blob], pid
+    assert not [n for n in needles if n in out_blob], pid
+
+
+def test_private_ci_privacy_needles_are_supported(monkeypatch):
+    monkeypatch.setenv("HWPX_PRIVATE_PII_NEEDLES", "private-ci-sentinel,second-private-marker")
+    assert _privacy_needles()[-2:] == ["private-ci-sentinel", "second-private-marker"]
 
 
 # --------------------------------------------------------------------------- #

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_document_plan_computed_fields.py

@@ -7,7 +7,7 @@ from hwpx import (
     create_document_from_plan,
     validate_document_plan,
 )
-from hwpx.builder import Bullet, Document, Heading, Paragraph, Run, Section, Table
+from hwpx.builder import Bullet, Document, Heading, Paragraph, Run, Section
 from hwpx.document import HwpxDocument
 
 DOCUMENT_PLAN_V2_SCHEMA_VERSION = "hwpx.document_plan.v2"

{python_hwpx-2.29.1 → python_hwpx-3.0.0}/tests/test_document_save_api.py

@@ -8,7 +8,6 @@ from zipfile import ZipFile
 import pytest
 from lxml import etree
 
-import hwpx.document as document_module
 from hwpx.document import HwpxDocument
 from hwpx.opc.package import HwpxPackageError
 from hwpx.tools.package_validator import validate_editor_open_safety