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

{python_hwpx-2.24.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.24.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"
@@ -202,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.24.0 → python_hwpx-2.24.1}/README.md

@@ -160,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.24.0 → python_hwpx-2.24.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "2.24.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.24.0 → python_hwpx-2.24.1}/src/hwpx/oxml/_document_impl.py

@@ -2796,14 +2796,23 @@ class HwpxOxmlTableCell:
         preserve_format: bool = True,
         split_paragraphs: bool = False,
     ) -> None:
+        previous_text = self.text
+        sanitized_value = _sanitize_text(value)
+        if sanitized_value and sanitized_value != previous_text:
+            sublist = self._ensure_sublist()
+            if (sublist.get("lineWrap") or "").upper() == "SQUEEZE":
+                # SQUEEZE can compress a longer filled value until Hancom
+                # renders adjacent glyphs on top of each other.  New content
+                # should wrap/reflow; untouched template cells keep their mode.
+                sublist.set("lineWrap", "BREAK")
         if split_paragraphs:
-            self._set_split_paragraph_text(value)
+            self._set_split_paragraph_text(sanitized_value)
             self.element.set("dirty", "1")
             self.table.mark_dirty()
             return
 
         text_element = self._ensure_text_element()
-        text_element.text = _sanitize_text(value)
+        text_element.text = sanitized_value
         for node in self.element.findall(f".//{_HP}t"):
             if node is text_element:
                 continue

{python_hwpx-2.24.0 → python_hwpx-2.24.1}/src/hwpx/table_patch.py

@@ -182,6 +182,9 @@ def build_grid(table: bytes) -> tuple[dict[tuple[int, int], _Cell], GridReport]:
 
 
 _P_SPAN_RE = re.compile(rb"<(?:[A-Za-z_][\w.-]*:)?p\b.*?</(?:[A-Za-z_][\w.-]*:)?p>", re.DOTALL)
+_SQUEEZE_WRAP_RE = re.compile(
+    rb'<(?:[A-Za-z_][\w.-]*:)?subList\b[^>]*?\blineWrap="(?P<value>SQUEEZE)"'
+)
 
 def _first_paragraph_span(cell: bytes) -> tuple[int, int] | None:
     """Byte span of the cell's first ``<hp:p>...</hp:p>`` (its own subList's
@@ -196,6 +199,22 @@ def _all_paragraph_spans(cell: bytes) -> list[tuple[int, int]]:
     return [(m.start(), m.end()) for m in _P_SPAN_RE.finditer(masked)]
 
 
+def _squeeze_wrap_edit(cell: bytes) -> tuple[int, int, bytes] | None:
+    """Return a minimal edit that makes a filled cell wrap instead of squeeze.
+
+    Hancom's ``lineWrap=SQUEEZE`` keeps long replacement text on the existing
+    line by compressing glyph advances.  Template placeholders often fit, but
+    real filled values can become nearly unreadable even though their charPr
+    spacing is normal.  Only the addressed cell's direct subList is considered;
+    nested tables remain untouched.
+    """
+
+    match = _SQUEEZE_WRAP_RE.search(_mask_nested_tables(cell))
+    if match is None:
+        return None
+    return match.start("value"), match.end("value"), b"BREAK"
+
+
 # --- font shrink-to-fit helpers (byte-preserving charPr materialisation) ------
 
 def _header_part_name(parts: Mapping[str, bytes]) -> str | None:
@@ -602,6 +621,17 @@ def fill_cells(
                 continue
             if not cell_edits:
                 continue
+            # A template's short placeholder may legitimately fit under
+            # lineWrap=SQUEEZE, while a real filled value is compressed until
+            # glyphs appear to overlap.  Changed non-empty values must wrap and
+            # reflow; preserve SQUEEZE for no-op/clear operations.
+            if text.strip():
+                wrap_edit = _squeeze_wrap_edit(cell_bytes)
+                if wrap_edit is not None:
+                    ws, we, replacement = wrap_edit
+                    section_edits.append(
+                        (ts + cell.start + ws, ts + cell.start + we, replacement)
+                    )
             section_edits.extend(cell_edits)
             applied.append(CellApplied(section_path, ti, row, col, first_orig or "", text))
         if section_edits:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.24.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"
@@ -202,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.24.0 → python_hwpx-2.24.1}/src/python_hwpx.egg-info/requires.txt

@@ -1,4 +1,4 @@
-lxml<6,>=4.9
+lxml<7,>=4.9
 
 [dev]
 build>=1.0

{python_hwpx-2.24.0 → python_hwpx-2.24.1}/tests/test_document_formatting.py

@@ -405,6 +405,28 @@ def test_table_set_cell_text_removes_layout_cache() -> None:
     assert paragraph.find(f"{HP}linesegarray") is None
 
 
+def test_table_set_cell_text_converts_squeeze_to_break() -> None:
+    section_element = ET.Element(f"{HS}sec")
+    section = HwpxOxmlSection("section0.xml", section_element)
+    manifest = ET.Element("manifest")
+    root = HwpxOxmlDocument(manifest, [section], [])
+    document = HwpxDocument(cast(HwpxPackage, object()), root)
+
+    table = document.add_table(1, 1, section=section)
+    cell = table.cell(0, 0)
+    sublist = cell.element.find(f"{HP}subList")
+    assert sublist is not None
+    sublist.set("lineWrap", "SQUEEZE")
+
+    table.set_cell_text(0, 0, "한 줄 폭을 넘는 신규 검토 의견 " * 8)
+
+    assert sublist.get("lineWrap") == "BREAK"
+
+    sublist.set("lineWrap", "SQUEEZE")
+    table.set_cell_text(0, 0, cell.text)
+    assert sublist.get("lineWrap") == "SQUEEZE"
+
+
 def test_save_removes_stale_layout_cache_after_low_level_text_edit() -> None:
     document = HwpxDocument.new()
     try:

{python_hwpx-2.24.0 → python_hwpx-2.24.1}/tests/test_table_patch.py

@@ -107,6 +107,48 @@ def test_fill_changes_only_target_and_preserves_rest(simple):
     assert "CELL_FILLED_X" in sec2.decode("utf-8")
 
 
+def test_fill_cell_converts_squeeze_to_break_only_in_touched_cell(merged):
+    _, sec = _section(merged)
+    targets = []
+    for ti, (start, end) in enumerate(_iter_table_spans(sec)):
+        table = sec[start:end]
+        for cell in _direct_cells(table):
+            cell_bytes = table[cell.start:cell.end]
+            if b'lineWrap="SQUEEZE"' in cell_bytes:
+                targets.append((ti, cell.row, cell.col))
+    assert len(targets) >= 2
+
+    ti, row, col = targets[0]
+    result = fill_cells(
+        merged,
+        [{"table_index": ti, "row": row, "col": col, "text": "긴 신규 검토 의견 " * 12}],
+    )
+    assert result.ok
+
+    _, changed_section = _section(result.data)
+    changed_spans = _iter_table_spans(changed_section)
+    changed_table = changed_section[changed_spans[ti][0]:changed_spans[ti][1]]
+    changed_cell = build_grid(changed_table)[0][(row, col)]
+    changed_cell_bytes = changed_table[changed_cell.start:changed_cell.end]
+    assert b'lineWrap="BREAK"' in changed_cell_bytes
+    assert b'lineWrap="SQUEEZE"' not in changed_cell_bytes
+
+    other_ti, other_row, other_col = targets[1]
+    other_table = changed_section[changed_spans[other_ti][0]:changed_spans[other_ti][1]]
+    other_cell = build_grid(other_table)[0][(other_row, other_col)]
+    assert b'lineWrap="SQUEEZE"' in other_table[other_cell.start:other_cell.end]
+
+    original_table = sec[_iter_table_spans(sec)[ti][0]:_iter_table_spans(sec)[ti][1]]
+    original_cell = build_grid(original_table)[0][(row, col)]
+    original_text = _cell_text(original_table, original_cell)
+    noop = fill_cells(
+        merged,
+        [{"table_index": ti, "row": row, "col": col, "text": original_text}],
+    )
+    assert noop.byte_identical is True
+    assert noop.data == merged
+
+
 def test_untouched_table_is_byte_identical(merged):
     _, sec = _section(merged)
     spans = _iter_table_spans(sec)