python-hwpx 6.4.0__tar.gz → 6.6.0__tar.gz

{python_hwpx-6.4.0/src/python_hwpx.egg-info → python_hwpx-6.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 6.4.0
+Version: 6.6.0
 Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
@@ -218,13 +218,15 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
 
 | | python-hwpx | pyhwpx | pyhwp |
 |---|---|---|---|
-| **대상 포맷** | `.hwpx` (OWPML/OPC) | `.hwpx` | `.hwp` (v5 바이너리) |
+| **대상 포맷** | `.hwpx` (OWPML/OPC), `.hwp` (HWP 5.0) | `.hwpx` | `.hwp` (v5 바이너리) |
 | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
 | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 | **편집/생성 API** | ✅ | ✅ (COM) | ❌ 대부분 읽기 |
 | **AI 에이전트 연동 (MCP)** | ✅ companion 경유 | ❌ | ❌ |
 
-> HWP(v5 바이너리)는 지원하지 않습니다. 한컴오피스에서 HWPX로 변환 후 사용하세요.
+> HWP 5.0(`.hwp`)은 `HwpxDocument.open`으로 열어 같은 API로 편집하고,
+> `save_to_path("x.hwp")`로 HWP로 저장합니다. 옮기지 못한 내용은
+> `document.conversion_report`에 남고, 암호·배포용 문서는 `Hwp5Error`로 거부합니다.
 
 ## 알려진 제약
 
@@ -232,7 +234,7 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
   열지 못하는 파일이 됩니다(호출 시 경고만 나옵니다). 도형은 `add_line()` /
   `add_rectangle()` / `add_ellipse()`를 쓰세요.
 - 그림은 단순 개체 생성까지 지원합니다 (그룹·효과 미지원).
-- 암호화된 HWPX는 지원하지 않습니다.
+- 암호화된 HWPX와 암호·배포용 HWP는 지원하지 않습니다.
 
 ## 기여하기
 

{python_hwpx-6.4.0 → python_hwpx-6.6.0}/README.md

@@ -167,13 +167,15 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
 
 | | python-hwpx | pyhwpx | pyhwp |
 |---|---|---|---|
-| **대상 포맷** | `.hwpx` (OWPML/OPC) | `.hwpx` | `.hwp` (v5 바이너리) |
+| **대상 포맷** | `.hwpx` (OWPML/OPC), `.hwp` (HWP 5.0) | `.hwpx` | `.hwp` (v5 바이너리) |
 | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
 | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 | **편집/생성 API** | ✅ | ✅ (COM) | ❌ 대부분 읽기 |
 | **AI 에이전트 연동 (MCP)** | ✅ companion 경유 | ❌ | ❌ |
 
-> HWP(v5 바이너리)는 지원하지 않습니다. 한컴오피스에서 HWPX로 변환 후 사용하세요.
+> HWP 5.0(`.hwp`)은 `HwpxDocument.open`으로 열어 같은 API로 편집하고,
+> `save_to_path("x.hwp")`로 HWP로 저장합니다. 옮기지 못한 내용은
+> `document.conversion_report`에 남고, 암호·배포용 문서는 `Hwp5Error`로 거부합니다.
 
 ## 알려진 제약
 
@@ -181,7 +183,7 @@ GitHub Release에 첨부되는 `py3-none-any` wheel을 문서와 함께 올리
   열지 못하는 파일이 됩니다(호출 시 경고만 나옵니다). 도형은 `add_line()` /
   `add_rectangle()` / `add_ellipse()`를 쓰세요.
 - 그림은 단순 개체 생성까지 지원합니다 (그룹·효과 미지원).
-- 암호화된 HWPX는 지원하지 않습니다.
+- 암호화된 HWPX와 암호·배포용 HWP는 지원하지 않습니다.
 
 ## 기여하기
 

{python_hwpx-6.4.0 → python_hwpx-6.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "6.4.0"
+version = "6.6.0"
 description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
@@ -109,6 +109,9 @@ packages = [
     "hwpx.data",
     "hwpx.equation",
     "hwpx.form_fit",
+    # HWP 5.0(.hwp) 읽기·쓰기. `hwpx/__init__.py`가 이 패키지를 가져오므로 빠지면
+    # 휠에서 `import hwpx`가 깨진다.
+    "hwpx.hwp5",
     "hwpx.ingest",
     "hwpx.layout",
     # 6.0: add_* 가 반환하는 도메인 객체·결과 dataclass (WP-C가 채운다).
@@ -283,6 +286,45 @@ files = [
     # headroom -- same escape valve as dutmal_compose.py/objects.py/
     # field_marks.py above, per the WP-A rule.
     "src/hwpx/oxml/note_authoring.py",
+    # Grid clean-up after a cell merge (rows left without cells, columns no
+    # cell starts at) moved out of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_merge.py",
+    # Hyperlink field target form (Hancom's Command/Path parameters,
+    # written and read in one place) -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/hyperlink_form.py",
+    # Table width/height distribution (distribute cell width row by row) moved out
+    # of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_sizes.py",
+    # Floating-shape reference frames (set_position) and shape-text
+    # vertical alignment -- objects.py's overflow module (1600-line cap),
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/shape_position.py",
+    # Font table and border-fill reads plus replace_font (header.xml) --
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/header_fonts.py",
+    # HWP 5.0 (.hwp) container and record layer -- born in the gate, per the
+    # WP-A rule.
+    "src/hwpx/hwp5/__init__.py",
+    "src/hwpx/hwp5/bodytext.py",
+    "src/hwpx/hwp5/cfb.py",
+    "src/hwpx/hwp5/docinfo.py",
+    "src/hwpx/hwp5/errors.py",
+    "src/hwpx/hwp5/fileheader.py",
+    "src/hwpx/hwp5/reader.py",
+    "src/hwpx/hwp5/records.py",
+    "src/hwpx/hwp5/binary.py",
+    "src/hwpx/hwp5/header_xml.py",
+    "src/hwpx/hwp5/owpml.py",
+    "src/hwpx/hwp5/package.py",
+    "src/hwpx/hwp5/section_xml.py",
+    "src/hwpx/hwp5/summary.py",
+    "src/hwpx/hwp5/controls.py",
+    "src/hwpx/hwp5/docinfo_writer.py",
+    "src/hwpx/hwp5/section_writer.py",
+    "src/hwpx/hwp5/shapes.py",
+    "src/hwpx/hwp5/section_common.py",
+    "src/hwpx/hwp5/shape_xml.py",
+    "src/hwpx/hwp5/writer.py",
 ]
 # 칩 후보 1 ✅ 6.14 트레인㊾-1에서 해소: `src/hwpx/table_patch.py`(2073줄,
 # 6.12 트레인㊸ 갭⑤ 정리 시 team-lead가 지목, f7e4e67 리뷰) — 위 files
@@ -450,6 +492,45 @@ include = [
     # headroom -- same escape valve as dutmal_compose.py/objects.py/
     # field_marks.py above, per the WP-A rule.
     "src/hwpx/oxml/note_authoring.py",
+    # Grid clean-up after a cell merge (rows left without cells, columns no
+    # cell starts at) moved out of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_merge.py",
+    # Hyperlink field target form (Hancom's Command/Path parameters,
+    # written and read in one place) -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/hyperlink_form.py",
+    # Table width/height distribution (distribute cell width row by row) moved out
+    # of table.py -- born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/table_sizes.py",
+    # Floating-shape reference frames (set_position) and shape-text
+    # vertical alignment -- objects.py's overflow module (1600-line cap),
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/shape_position.py",
+    # Font table and border-fill reads plus replace_font (header.xml) --
+    # born in the gate, per the WP-A rule.
+    "src/hwpx/oxml/header_fonts.py",
+    # HWP 5.0 (.hwp) container and record layer -- born in the gate, per the
+    # WP-A rule.
+    "src/hwpx/hwp5/__init__.py",
+    "src/hwpx/hwp5/bodytext.py",
+    "src/hwpx/hwp5/cfb.py",
+    "src/hwpx/hwp5/docinfo.py",
+    "src/hwpx/hwp5/errors.py",
+    "src/hwpx/hwp5/fileheader.py",
+    "src/hwpx/hwp5/reader.py",
+    "src/hwpx/hwp5/records.py",
+    "src/hwpx/hwp5/binary.py",
+    "src/hwpx/hwp5/header_xml.py",
+    "src/hwpx/hwp5/owpml.py",
+    "src/hwpx/hwp5/package.py",
+    "src/hwpx/hwp5/section_xml.py",
+    "src/hwpx/hwp5/summary.py",
+    "src/hwpx/hwp5/controls.py",
+    "src/hwpx/hwp5/docinfo_writer.py",
+    "src/hwpx/hwp5/section_writer.py",
+    "src/hwpx/hwp5/shapes.py",
+    "src/hwpx/hwp5/section_common.py",
+    "src/hwpx/hwp5/shape_xml.py",
+    "src/hwpx/hwp5/writer.py",
 ]
 pythonVersion = "3.10"
 typeCheckingMode = "basic"

{python_hwpx-6.4.0 → python_hwpx-6.6.0}/src/hwpx/__init__.py

@@ -376,6 +376,7 @@ from .tools.package_validator import (
 )
 from .ingest import HwpxMarkdownConverter
 from .errors import HwpxError
+from .hwp5.errors import Hwp5ConversionWarning, Hwp5Error
 from .mutation_report import (
     MutationReport,
     PreservationDowngradeError,
@@ -415,6 +416,8 @@ __all__ = [
     "PackageValidationReport",
     "BytePreservingPatchResult",
     "HwpxError",
+    "Hwp5Error",
+    "Hwp5ConversionWarning",
     "MutationReport",
     "PreservationDowngradeError",
     "ParagraphTextPatch",

{python_hwpx-6.4.0 → python_hwpx-6.6.0}/src/hwpx/_document/_legacy.py

@@ -1241,7 +1241,9 @@ class _LegacyFacade:
         """Remove an embedded image by its manifest item id.
 
         This removes the binary data from the ZIP, the manifest entry, and
-        the header binItem entry.
+        the header binItem entry. An item the document still points at is
+        refused with ``HwpxValueError`` (code ``media-item-in-use``);
+        ``doc.media.remove_image(item_id, force=True)`` removes it anyway.
 
         Returns:
             ``True`` if any component was removed.

{python_hwpx-6.4.0 → python_hwpx-6.6.0}/src/hwpx/_document/fields.py

@@ -8,10 +8,11 @@ from typing import TYPE_CHECKING, Any, Iterator, Mapping, Sequence, cast
 
 from ..errors import HwpxStateError, HwpxValueError
 from ..objects.checkbox import CheckBox
-from ..objects.form_field import FieldLocation, FieldParameter, FormField
+from ..objects.form_field import CellField, FieldLocation, FieldParameter, FormField
 from ..objects.results import FieldFillResult
 from ..oxml import HwpxOxmlParagraph
 from ..oxml.namespaces import HP
+from ..oxml.section_story import control_twins
 
 if TYPE_CHECKING:
     from hwpx.document import HwpxDocument
@@ -291,11 +292,13 @@ def _iter_form_field_matches(doc: "HwpxDocument") -> list[dict[str, Any]]:
             paragraph.element: index
             for index, paragraph in enumerate(section.paragraphs)
         }
+        # a header/footer python-hwpx keeps twice counts once: its hp:secPr copy
+        twins = control_twins(section.element)
 
         def iter_content_paragraphs(element: Any) -> Iterator[Any]:
             for child in element:
                 local = _local_name(child)
-                if local == "memogroup":
+                if local == "memogroup" or child in twins:
                     continue
                 if local == "p":
                     yield child
@@ -403,6 +406,42 @@ def list_form_fields(doc: "HwpxDocument") -> tuple[FormField, ...]:
     return tuple(_form_field_from_match(doc, match) for match in _iter_form_field_matches(doc))
 
 
+def _named_cells(paragraphs: Any) -> Iterator[Any]:
+    for paragraph in paragraphs:
+        for table in paragraph.tables:
+            for row in table.rows:
+                for cell in row.cells:
+                    if cell.field_name:
+                        yield cell
+                    yield from _named_cells(cell.paragraphs)
+
+
+def list_cell_fields(doc: "HwpxDocument") -> tuple[CellField, ...]:
+    """Named table cells (Hancom's cell fields) in document order: body tables and the tables in their cells."""
+
+    return tuple(CellField(cell) for section in doc.sections for cell in _named_cells(section.paragraphs))
+
+
+def fill_cell_fields(doc: "HwpxDocument", value: str, *, name: str, index: int | None = None) -> tuple[CellField, ...]:
+    """Set the text of every cell field called *name*, or of the *index*-th of them only."""
+
+    wanted = (name or "").strip()
+    fields = [field for field in list_cell_fields(doc) if wanted and field.name == wanted]
+    if index is not None:
+        fields = fields[index : index + 1] if index >= 0 else []
+    if not fields:
+        where = f"{wanted!r}" if index is None else f"{wanted!r} at index {index}"
+        raise HwpxValueError(
+            f"no cell field named {where}",
+            code="field-cell-not-found",
+            context={"name": wanted, "index": index},
+            suggestion="List doc.fields.cells to see the cell field names.",
+        )
+    for field in fields:
+        field.text = value
+    return tuple(fields)
+
+
 _PROMPT_TEXT_COLOR = "#FF0000"
 
 
@@ -823,7 +862,10 @@ def _measure_form_field_fit(
 ) -> "FitResult":
     """Run the FormFit engine for a native field (plan §2 C)."""
 
+    from dataclasses import replace
+
     from hwpx.form_fit import DEFAULT_SAFETY, FitEngine, FitResult, SlotMetrics
+    from hwpx.form_fit.measure import text_style_from_refs
 
     runs = match["_runs"]
     begin_index = int(match["_begin_run_index"])
@@ -850,10 +892,16 @@ def _measure_form_field_fit(
             field_id=field_id,
         )
 
+    # The field sits inside its paragraph, so the paragraph's indent does not
+    # apply to the box.
+    text_style = text_style_from_refs(
+        doc._root, match["_paragraph"].para_pr_id_ref, [begin_ref]
+    )
     slot = SlotMetrics(
         available_width=float(box_width) * DEFAULT_SAFETY,
         font_pt=resolved_pt,
         max_lines=fit_policy.effective_max_lines,
+        text_style=replace(text_style, indent=0),
     )
     return FitEngine().fit(value, slot, fit_policy, field_id=field_id)