python-hwpx 6.11.0__tar.gz → 7.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- python_hwpx-7.0.0/MANIFEST.in +8 -0
- {python_hwpx-6.11.0/src/python_hwpx.egg-info → python_hwpx-7.0.0}/PKG-INFO +88 -53
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/README.md +75 -48
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/pyproject.toml +68 -33
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/__init__.py +114 -65
- python_hwpx-7.0.0/src/hwpx/_document/_legacy.py +84 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/_resolve.py +115 -24
- python_hwpx-7.0.0/src/hwpx/_document/_units.py +42 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/fields.py +881 -51
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/headings.py +10 -20
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/highlight.py +64 -5
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/layout.py +353 -224
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/media.py +254 -81
- python_hwpx-7.0.0/src/hwpx/_document/memos.py +520 -0
- python_hwpx-7.0.0/src/hwpx/_document/ns/_base.py +111 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/fields.py +171 -21
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/media.py +32 -15
- python_hwpx-7.0.0/src/hwpx/_document/ns/notes.py +289 -0
- python_hwpx-7.0.0/src/hwpx/_document/ns/page.py +1292 -0
- python_hwpx-7.0.0/src/hwpx/_document/ns/parts.py +552 -0
- python_hwpx-7.0.0/src/hwpx/_document/ns/refs.py +190 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/shapes.py +198 -122
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/styles.py +536 -175
- python_hwpx-7.0.0/src/hwpx/_document/ns/tables.py +172 -0
- python_hwpx-7.0.0/src/hwpx/_document/ns/text.py +627 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/tracking.py +67 -16
- python_hwpx-7.0.0/src/hwpx/_document/persistence.py +870 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/shapes.py +183 -119
- python_hwpx-7.0.0/src/hwpx/_document/text_blocks.py +911 -0
- python_hwpx-7.0.0/src/hwpx/_document/tracked.py +699 -0
- python_hwpx-7.0.0/src/hwpx/_moved_modules.py +324 -0
- python_hwpx-7.0.0/src/hwpx/_removed_names.py +1235 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/body_patch.py +172 -32
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/capabilities.py +77 -65
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/known-traps.md +29 -12
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/mutation-semantics.md +14 -11
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/recipes-traversal.md +8 -8
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/support-matrix.md +35 -31
- python_hwpx-7.0.0/src/hwpx/document.py +1120 -0
- python_hwpx-7.0.0/src/hwpx/equation/__init__.py +47 -0
- python_hwpx-7.0.0/src/hwpx/equation/authoring.py +807 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/equation/eqedit.py +168 -16
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/equation/measure.py +208 -42
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/equation/tokens.py +84 -0
- python_hwpx-7.0.0/src/hwpx/errors.py +782 -0
- python_hwpx-7.0.0/src/hwpx/experimental.py +76 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/__init__.py +7 -1
- python_hwpx-7.0.0/src/hwpx/form_fit/_glyph_table.json.gz +0 -0
- python_hwpx-7.0.0/src/hwpx/form_fit/_glyph_table.py +75 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/measure.py +4 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/cfb.py +37 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/docinfo.py +8 -6
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/docinfo_writer.py +12 -7
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/header_xml.py +75 -18
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/owpml.py +7 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/package.py +110 -11
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/reader.py +3 -5
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/records.py +19 -5
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_writer.py +21 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_xml.py +170 -30
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/shape_xml.py +2 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/summary.py +27 -2
- python_hwpx-6.11.0/src/hwpx/layout/pages.py → python_hwpx-7.0.0/src/hwpx/layout/_page_measure.py +139 -2414
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/layout/line_cache.py +33 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/layout/lint.py +5 -5
- python_hwpx-7.0.0/src/hwpx/layout/pages.py +2490 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/model.py +7 -1
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/mutation_report.py +123 -14
- python_hwpx-7.0.0/src/hwpx/objects/__init__.py +275 -0
- python_hwpx-7.0.0/src/hwpx/objects/binary_item.py +34 -0
- python_hwpx-7.0.0/src/hwpx/objects/checkbox.py +392 -0
- python_hwpx-7.0.0/src/hwpx/objects/form_field.py +1117 -0
- python_hwpx-7.0.0/src/hwpx/objects/highlight.py +283 -0
- python_hwpx-7.0.0/src/hwpx/objects/results.py +1182 -0
- python_hwpx-7.0.0/src/hwpx/opc/package.py +2189 -0
- python_hwpx-7.0.0/src/hwpx/opc/security.py +502 -0
- python_hwpx-7.0.0/src/hwpx/opc/xml_utils.py +354 -0
- python_hwpx-7.0.0/src/hwpx/opc/zip_records.py +262 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/__init__.py +5 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/_document_impl.py +1 -1
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/_document_primitives.py +424 -99
- python_hwpx-7.0.0/src/hwpx/oxml/_paragraph_text_edit.py +1470 -0
- python_hwpx-7.0.0/src/hwpx/oxml/caret.py +169 -0
- python_hwpx-7.0.0/src/hwpx/oxml/container.py +1218 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/curves.py +71 -13
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document_metadata.py +52 -4
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document_parts.py +246 -135
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/drop_cap.py +18 -6
- python_hwpx-7.0.0/src/hwpx/oxml/dutmal_compose.py +372 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/field_marks.py +181 -18
- python_hwpx-7.0.0/src/hwpx/oxml/formatting.py +1640 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header.py +90 -24
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_fonts.py +180 -33
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_part.py +312 -100
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/hyperlink_form.py +117 -1
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/master_page_authoring.py +79 -4
- python_hwpx-7.0.0/src/hwpx/oxml/memo.py +1172 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/namespaces.py +41 -0
- python_hwpx-7.0.0/src/hwpx/oxml/note_authoring.py +606 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/numbering.py +2 -13
- python_hwpx-7.0.0/src/hwpx/oxml/numbering_kinds.py +569 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/objects.py +568 -204
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/paragraph.py +620 -205
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/paragraph_heading.py +50 -0
- python_hwpx-7.0.0/src/hwpx/oxml/run.py +1484 -0
- python_hwpx-7.0.0/src/hwpx/oxml/section.py +1320 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_format.py +311 -215
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_layout.py +4 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_story.py +216 -67
- python_hwpx-7.0.0/src/hwpx/oxml/shape_position.py +3139 -0
- python_hwpx-7.0.0/src/hwpx/oxml/simple_parts.py +231 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table.py +248 -149
- python_hwpx-7.0.0/src/hwpx/oxml/table_format.py +1048 -0
- python_hwpx-7.0.0/src/hwpx/oxml/table_merge.py +229 -0
- python_hwpx-7.0.0/src/hwpx/oxml/table_rows.py +280 -0
- python_hwpx-7.0.0/src/hwpx/oxml/table_sizes.py +1044 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table_structure.py +144 -18
- python_hwpx-7.0.0/src/hwpx/oxml/text_offsets.py +104 -0
- python_hwpx-7.0.0/src/hwpx/oxml/text_ranges.py +1506 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/utils.py +39 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/patch.py +317 -188
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/quality/__init__.py +4 -4
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/quality/policy.py +1 -1
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/quality/save_pipeline.py +155 -28
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/table_patch.py +86 -82
- python_hwpx-7.0.0/src/hwpx/templates.py +100 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/__init__.py +15 -91
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/archive_cli.py +82 -13
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/doc_diff.py +20 -125
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/document_merge.py +601 -77
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/exporter.py +219 -175
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/generic_inventory.py +2 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/ir_equality.py +9 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/object_finder.py +3 -2
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/package_validator.py +134 -33
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/page_guard.py +11 -1
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/recover.py +5 -1
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/redline.py +15 -5
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/repair.py +79 -13
- python_hwpx-7.0.0/src/hwpx/tools/table_navigation.py +302 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/template_analyzer.py +7 -2
- python_hwpx-7.0.0/src/hwpx/tools/text_extract_cli.py +135 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/text_extractor.py +71 -8
- python_hwpx-7.0.0/src/hwpx/tools/toc_author.py +921 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/toc_fidelity.py +4 -1
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/validator.py +51 -11
- {python_hwpx-6.11.0 → python_hwpx-7.0.0/src/python_hwpx.egg-info}/PKG-INFO +88 -53
- python_hwpx-7.0.0/src/python_hwpx.egg-info/SOURCES.txt +208 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/requires.txt +11 -3
- python_hwpx-6.11.0/src/hwpx/_document/_legacy.py +0 -1762
- python_hwpx-6.11.0/src/hwpx/_document/_units.py +0 -16
- python_hwpx-6.11.0/src/hwpx/_document/memos.py +0 -328
- python_hwpx-6.11.0/src/hwpx/_document/ns/_base.py +0 -40
- python_hwpx-6.11.0/src/hwpx/_document/ns/notes.py +0 -210
- python_hwpx-6.11.0/src/hwpx/_document/ns/page.py +0 -615
- python_hwpx-6.11.0/src/hwpx/_document/ns/parts.py +0 -374
- python_hwpx-6.11.0/src/hwpx/_document/ns/refs.py +0 -86
- python_hwpx-6.11.0/src/hwpx/_document/ns/tables.py +0 -126
- python_hwpx-6.11.0/src/hwpx/_document/ns/text.py +0 -312
- python_hwpx-6.11.0/src/hwpx/_document/persistence.py +0 -525
- python_hwpx-6.11.0/src/hwpx/_document/tracked.py +0 -290
- python_hwpx-6.11.0/src/hwpx/_moved_modules.py +0 -118
- python_hwpx-6.11.0/src/hwpx/document.py +0 -918
- python_hwpx-6.11.0/src/hwpx/equation/__init__.py +0 -54
- python_hwpx-6.11.0/src/hwpx/equation/authoring.py +0 -473
- python_hwpx-6.11.0/src/hwpx/equation/mathml.py +0 -135
- python_hwpx-6.11.0/src/hwpx/equation/render.py +0 -83
- python_hwpx-6.11.0/src/hwpx/errors.py +0 -437
- python_hwpx-6.11.0/src/hwpx/experimental.py +0 -84
- python_hwpx-6.11.0/src/hwpx/form_fit/_glyph_table.py +0 -12023
- python_hwpx-6.11.0/src/hwpx/ingest/__init__.py +0 -26
- python_hwpx-6.11.0/src/hwpx/ingest/base.py +0 -230
- python_hwpx-6.11.0/src/hwpx/ingest/hwpx_converter.py +0 -139
- python_hwpx-6.11.0/src/hwpx/objects/__init__.py +0 -73
- python_hwpx-6.11.0/src/hwpx/objects/binary_item.py +0 -58
- python_hwpx-6.11.0/src/hwpx/objects/checkbox.py +0 -103
- python_hwpx-6.11.0/src/hwpx/objects/form_field.py +0 -348
- python_hwpx-6.11.0/src/hwpx/objects/highlight.py +0 -41
- python_hwpx-6.11.0/src/hwpx/objects/results.py +0 -373
- python_hwpx-6.11.0/src/hwpx/opc/package.py +0 -1328
- python_hwpx-6.11.0/src/hwpx/opc/security.py +0 -240
- python_hwpx-6.11.0/src/hwpx/opc/xml_utils.py +0 -147
- python_hwpx-6.11.0/src/hwpx/oxml/_paragraph_text_edit.py +0 -138
- python_hwpx-6.11.0/src/hwpx/oxml/container.py +0 -377
- python_hwpx-6.11.0/src/hwpx/oxml/dutmal_compose.py +0 -134
- python_hwpx-6.11.0/src/hwpx/oxml/memo.py +0 -567
- python_hwpx-6.11.0/src/hwpx/oxml/note_authoring.py +0 -194
- python_hwpx-6.11.0/src/hwpx/oxml/numbering_kinds.py +0 -178
- python_hwpx-6.11.0/src/hwpx/oxml/run.py +0 -656
- python_hwpx-6.11.0/src/hwpx/oxml/section.py +0 -731
- python_hwpx-6.11.0/src/hwpx/oxml/shape_position.py +0 -600
- python_hwpx-6.11.0/src/hwpx/oxml/simple_parts.py +0 -123
- python_hwpx-6.11.0/src/hwpx/oxml/table_merge.py +0 -82
- python_hwpx-6.11.0/src/hwpx/oxml/table_sizes.py +0 -501
- python_hwpx-6.11.0/src/hwpx/templates.py +0 -34
- python_hwpx-6.11.0/src/hwpx/tools/document_viewer.py +0 -182
- python_hwpx-6.11.0/src/hwpx/tools/layout_preview.py +0 -697
- python_hwpx-6.11.0/src/hwpx/tools/mail_merge.py +0 -495
- python_hwpx-6.11.0/src/hwpx/tools/markdown_export.py +0 -590
- python_hwpx-6.11.0/src/hwpx/tools/report_utils.py +0 -132
- python_hwpx-6.11.0/src/hwpx/tools/table_cleanup.py +0 -61
- python_hwpx-6.11.0/src/hwpx/tools/table_navigation.py +0 -545
- python_hwpx-6.11.0/src/hwpx/tools/text_extract_cli.py +0 -67
- python_hwpx-6.11.0/src/hwpx/tools/toc_author.py +0 -475
- python_hwpx-6.11.0/src/python_hwpx.egg-info/SOURCES.txt +0 -484
- python_hwpx-6.11.0/tests/test_add_control.py +0 -83
- python_hwpx-6.11.0/tests/test_add_heading.py +0 -355
- python_hwpx-6.11.0/tests/test_adoption_metrics_snapshot.py +0 -90
- python_hwpx-6.11.0/tests/test_arc_authoring.py +0 -294
- python_hwpx-6.11.0/tests/test_authoring_defaults.py +0 -412
- python_hwpx-6.11.0/tests/test_authoring_quality_corpus.py +0 -514
- python_hwpx-6.11.0/tests/test_blind_eval_fixture.py +0 -155
- python_hwpx-6.11.0/tests/test_body_patch.py +0 -190
- python_hwpx-6.11.0/tests/test_border_fill_image_gradient.py +0 -361
- python_hwpx-6.11.0/tests/test_border_line_types.py +0 -72
- python_hwpx-6.11.0/tests/test_build_element_census.py +0 -186
- python_hwpx-6.11.0/tests/test_byte_patch_identity.py +0 -314
- python_hwpx-6.11.0/tests/test_capabilities_surface.py +0 -198
- python_hwpx-6.11.0/tests/test_cell_border_neighbors.py +0 -135
- python_hwpx-6.11.0/tests/test_cell_edit_holder_cache.py +0 -101
- python_hwpx-6.11.0/tests/test_cell_fields.py +0 -224
- python_hwpx-6.11.0/tests/test_cell_line_spacing.py +0 -90
- python_hwpx-6.11.0/tests/test_cell_margins.py +0 -311
- python_hwpx-6.11.0/tests/test_cell_text_rewrite_semantics.py +0 -145
- python_hwpx-6.11.0/tests/test_char_pr_child_order.py +0 -64
- python_hwpx-6.11.0/tests/test_character_width_ratio.py +0 -35
- python_hwpx-6.11.0/tests/test_chart_authoring.py +0 -313
- python_hwpx-6.11.0/tests/test_check_box_authoring.py +0 -154
- python_hwpx-6.11.0/tests/test_color_arguments.py +0 -170
- python_hwpx-6.11.0/tests/test_column_break.py +0 -109
- python_hwpx-6.11.0/tests/test_column_widths_as_shares.py +0 -119
- python_hwpx-6.11.0/tests/test_comment_node_robustness.py +0 -85
- python_hwpx-6.11.0/tests/test_container_authoring.py +0 -352
- python_hwpx-6.11.0/tests/test_container_members.py +0 -216
- python_hwpx-6.11.0/tests/test_contract_docs_sync.py +0 -41
- python_hwpx-6.11.0/tests/test_corpus_read_fidelity.py +0 -38
- python_hwpx-6.11.0/tests/test_coverage_ledger.py +0 -1069
- python_hwpx-6.11.0/tests/test_coverage_promotion.py +0 -671
- python_hwpx-6.11.0/tests/test_coverage_targets.py +0 -74
- python_hwpx-6.11.0/tests/test_curve_connector_authoring.py +0 -179
- python_hwpx-6.11.0/tests/test_deviations_registry.py +0 -454
- python_hwpx-6.11.0/tests/test_doc_diff.py +0 -71
- python_hwpx-6.11.0/tests/test_document_context_manager.py +0 -65
- python_hwpx-6.11.0/tests/test_document_facade_surface.py +0 -87
- python_hwpx-6.11.0/tests/test_document_formatting.py +0 -1995
- python_hwpx-6.11.0/tests/test_document_merge.py +0 -1318
- python_hwpx-6.11.0/tests/test_document_metadata.py +0 -141
- python_hwpx-6.11.0/tests/test_document_ops_runtime_boundary.py +0 -256
- python_hwpx-6.11.0/tests/test_document_save_api.py +0 -319
- python_hwpx-6.11.0/tests/test_document_viewer.py +0 -136
- python_hwpx-6.11.0/tests/test_documentation_code_fences.py +0 -531
- python_hwpx-6.11.0/tests/test_drop_cap_authoring.py +0 -258
- python_hwpx-6.11.0/tests/test_dutmal_compose_authoring.py +0 -238
- python_hwpx-6.11.0/tests/test_edit_fidelity_corpus.py +0 -311
- python_hwpx-6.11.0/tests/test_edit_plan.py +0 -356
- python_hwpx-6.11.0/tests/test_editor_surface_inventory.py +0 -119
- python_hwpx-6.11.0/tests/test_engine_surface_6_0.py +0 -461
- python_hwpx-6.11.0/tests/test_ensure_run_font_by_lang.py +0 -248
- python_hwpx-6.11.0/tests/test_equalize_widths_per_row.py +0 -297
- python_hwpx-6.11.0/tests/test_equation_authoring.py +0 -417
- python_hwpx-6.11.0/tests/test_equation_converter.py +0 -301
- python_hwpx-6.11.0/tests/test_equation_font_boundaries.py +0 -93
- python_hwpx-6.11.0/tests/test_equation_measure_hancom_saved.py +0 -99
- python_hwpx-6.11.0/tests/test_equation_render.py +0 -140
- python_hwpx-6.11.0/tests/test_equation_size.py +0 -109
- python_hwpx-6.11.0/tests/test_equation_width_hancom_boxes.py +0 -73
- python_hwpx-6.11.0/tests/test_error_contract.py +0 -235
- python_hwpx-6.11.0/tests/test_error_messages.py +0 -143
- python_hwpx-6.11.0/tests/test_evalplan_core_primitives.py +0 -71
- python_hwpx-6.11.0/tests/test_existing_document_format_editing.py +0 -203
- python_hwpx-6.11.0/tests/test_export_captions_dutmal.py +0 -162
- python_hwpx-6.11.0/tests/test_export_cell_text_spaces.py +0 -29
- python_hwpx-6.11.0/tests/test_export_list_labels.py +0 -194
- python_hwpx-6.11.0/tests/test_export_notes.py +0 -202
- python_hwpx-6.11.0/tests/test_export_text_boxes.py +0 -157
- python_hwpx-6.11.0/tests/test_exporter_table_text.py +0 -164
- python_hwpx-6.11.0/tests/test_field_marks.py +0 -328
- python_hwpx-6.11.0/tests/test_field_readers.py +0 -158
- python_hwpx-6.11.0/tests/test_field_type_ids.py +0 -120
- python_hwpx-6.11.0/tests/test_fill_image_hancom_modes.py +0 -73
- python_hwpx-6.11.0/tests/test_form_field_authoring.py +0 -221
- python_hwpx-6.11.0/tests/test_form_field_fill_cost.py +0 -66
- python_hwpx-6.11.0/tests/test_form_fields.py +0 -372
- python_hwpx-6.11.0/tests/test_form_fill_core_primitives.py +0 -38
- python_hwpx-6.11.0/tests/test_form_fit.py +0 -587
- python_hwpx-6.11.0/tests/test_form_fit_hancom_rules.py +0 -2100
- python_hwpx-6.11.0/tests/test_form_fit_integration.py +0 -200
- python_hwpx-6.11.0/tests/test_fuzz_catalog_derive_expected.py +0 -173
- python_hwpx-6.11.0/tests/test_fuzz_loop.py +0 -129
- python_hwpx-6.11.0/tests/test_fuzz_regressions.py +0 -56
- python_hwpx-6.11.0/tests/test_gap_and_new_number_values.py +0 -143
- python_hwpx-6.11.0/tests/test_gap_closure_tools.py +0 -788
- python_hwpx-6.11.0/tests/test_golden_api.py +0 -305
- python_hwpx-6.11.0/tests/test_header_compat_authoring.py +0 -319
- python_hwpx-6.11.0/tests/test_header_control_before_field.py +0 -78
- python_hwpx-6.11.0/tests/test_header_list_lookups.py +0 -71
- python_hwpx-6.11.0/tests/test_heading_style_shapes.py +0 -58
- python_hwpx-6.11.0/tests/test_highlight_authoring.py +0 -289
- python_hwpx-6.11.0/tests/test_hp_tab_support.py +0 -64
- python_hwpx-6.11.0/tests/test_hwp5_container.py +0 -255
- python_hwpx-6.11.0/tests/test_hwp5_hancom_files.py +0 -163
- python_hwpx-6.11.0/tests/test_hwp5_open.py +0 -1387
- python_hwpx-6.11.0/tests/test_hwp5_save.py +0 -1989
- python_hwpx-6.11.0/tests/test_hwpxlib_corpus_read.py +0 -36
- python_hwpx-6.11.0/tests/test_hyperlink_hancom_form.py +0 -110
- python_hwpx-6.11.0/tests/test_id_generator_range.py +0 -32
- python_hwpx-6.11.0/tests/test_id_integrity.py +0 -54
- python_hwpx-6.11.0/tests/test_image_object_workflow.py +0 -294
- python_hwpx-6.11.0/tests/test_index_mark.py +0 -158
- python_hwpx-6.11.0/tests/test_ingest.py +0 -65
- python_hwpx-6.11.0/tests/test_inline_models.py +0 -113
- python_hwpx-6.11.0/tests/test_insert_column_by_clone.py +0 -200
- python_hwpx-6.11.0/tests/test_insert_row_merged_cells.py +0 -130
- python_hwpx-6.11.0/tests/test_insert_row_sides.py +0 -193
- python_hwpx-6.11.0/tests/test_instid_attribute_case.py +0 -126
- python_hwpx-6.11.0/tests/test_integration_hwpx_compatibility.py +0 -228
- python_hwpx-6.11.0/tests/test_integration_roundtrip.py +0 -327
- python_hwpx-6.11.0/tests/test_internal_calls_skip_moved_names.py +0 -77
- python_hwpx-6.11.0/tests/test_known_leak_migration_contract.py +0 -94
- python_hwpx-6.11.0/tests/test_layer_leak_guard.py +0 -181
- python_hwpx-6.11.0/tests/test_layout_cache_scope.py +0 -293
- python_hwpx-6.11.0/tests/test_layout_line_cache.py +0 -960
- python_hwpx-6.11.0/tests/test_layout_lint.py +0 -816
- python_hwpx-6.11.0/tests/test_layout_page_estimate.py +0 -2925
- python_hwpx-6.11.0/tests/test_layout_preview.py +0 -60
- python_hwpx-6.11.0/tests/test_lazy_hwp5_import.py +0 -87
- python_hwpx-6.11.0/tests/test_lazy_tools_import.py +0 -91
- python_hwpx-6.11.0/tests/test_lazy_tools_submodules.py +0 -149
- python_hwpx-6.11.0/tests/test_library_boundary_closure.py +0 -195
- python_hwpx-6.11.0/tests/test_line_break_writing.py +0 -131
- python_hwpx-6.11.0/tests/test_line_width_arguments.py +0 -94
- python_hwpx-6.11.0/tests/test_list_continue.py +0 -112
- python_hwpx-6.11.0/tests/test_list_defaults_vs_hancom.py +0 -80
- python_hwpx-6.11.0/tests/test_list_level_range.py +0 -53
- python_hwpx-6.11.0/tests/test_llms_txt.py +0 -124
- python_hwpx-6.11.0/tests/test_mail_merge_xlsx.py +0 -38
- python_hwpx-6.11.0/tests/test_manifest_resolve_once.py +0 -52
- python_hwpx-6.11.0/tests/test_markdown_export.py +0 -436
- python_hwpx-6.11.0/tests/test_markdown_export_shape_text.py +0 -75
- python_hwpx-6.11.0/tests/test_master_page_authoring.py +0 -181
- python_hwpx-6.11.0/tests/test_master_page_pages_taken.py +0 -181
- python_hwpx-6.11.0/tests/test_memo_and_style_editing.py +0 -474
- python_hwpx-6.11.0/tests/test_memo_fields.py +0 -124
- python_hwpx-6.11.0/tests/test_memo_shape_authoring.py +0 -249
- python_hwpx-6.11.0/tests/test_merge_cells_hancom_files.py +0 -46
- python_hwpx-6.11.0/tests/test_merge_cells_keeps_contents.py +0 -180
- python_hwpx-6.11.0/tests/test_migration_seams.py +0 -116
- python_hwpx-6.11.0/tests/test_moved_module_imports.py +0 -105
- python_hwpx-6.11.0/tests/test_moved_surface_hints.py +0 -66
- python_hwpx-6.11.0/tests/test_mutation_report.py +0 -343
- python_hwpx-6.11.0/tests/test_namespace_handling.py +0 -134
- python_hwpx-6.11.0/tests/test_namespace_hygiene.py +0 -189
- python_hwpx-6.11.0/tests/test_namespace_normalization.py +0 -109
- python_hwpx-6.11.0/tests/test_native_edit_contract.py +0 -338
- python_hwpx-6.11.0/tests/test_nested_cell_fill_safety.py +0 -301
- python_hwpx-6.11.0/tests/test_nested_table_structure_edits.py +0 -192
- python_hwpx-6.11.0/tests/test_new_features.py +0 -593
- python_hwpx-6.11.0/tests/test_note_authoring_contract.py +0 -121
- python_hwpx-6.11.0/tests/test_ns_fields.py +0 -157
- python_hwpx-6.11.0/tests/test_ns_media.py +0 -94
- python_hwpx-6.11.0/tests/test_ns_notes.py +0 -120
- python_hwpx-6.11.0/tests/test_ns_page.py +0 -284
- python_hwpx-6.11.0/tests/test_ns_refs.py +0 -74
- python_hwpx-6.11.0/tests/test_ns_shapes.py +0 -198
- python_hwpx-6.11.0/tests/test_ns_tables.py +0 -130
- python_hwpx-6.11.0/tests/test_ns_tracking.py +0 -139
- python_hwpx-6.11.0/tests/test_number_formats.py +0 -132
- python_hwpx-6.11.0/tests/test_opc_package.py +0 -969
- python_hwpx-6.11.0/tests/test_open_safety_corpus.py +0 -88
- python_hwpx-6.11.0/tests/test_outline_numbering.py +0 -120
- python_hwpx-6.11.0/tests/test_oxml_modularization.py +0 -453
- python_hwpx-6.11.0/tests/test_oxml_parsing.py +0 -385
- python_hwpx-6.11.0/tests/test_package_hygiene.py +0 -558
- python_hwpx-6.11.0/tests/test_package_text_and_namespaces.py +0 -195
- python_hwpx-6.11.0/tests/test_packaging_license_metadata.py +0 -63
- python_hwpx-6.11.0/tests/test_packaging_py_typed.py +0 -42
- python_hwpx-6.11.0/tests/test_page_and_list_values.py +0 -161
- python_hwpx-6.11.0/tests/test_page_number_control.py +0 -323
- python_hwpx-6.11.0/tests/test_page_number_format.py +0 -73
- python_hwpx-6.11.0/tests/test_page_orientation.py +0 -157
- python_hwpx-6.11.0/tests/test_para_pr_dedup.py +0 -133
- python_hwpx-6.11.0/tests/test_paragraph_align_distribute_space.py +0 -41
- python_hwpx-6.11.0/tests/test_paragraph_border.py +0 -168
- python_hwpx-6.11.0/tests/test_paragraph_format_targets.py +0 -218
- python_hwpx-6.11.0/tests/test_paragraph_hyperlink_style.py +0 -127
- python_hwpx-6.11.0/tests/test_paragraph_keep_together.py +0 -46
- python_hwpx-6.11.0/tests/test_paragraph_margin_default_scale.py +0 -89
- python_hwpx-6.11.0/tests/test_paragraph_matcher.py +0 -126
- python_hwpx-6.11.0/tests/test_paragraph_property_lookup.py +0 -82
- python_hwpx-6.11.0/tests/test_paragraph_property_version_switch.py +0 -160
- python_hwpx-6.11.0/tests/test_paragraph_remove_in_containers.py +0 -133
- python_hwpx-6.11.0/tests/test_paragraph_section_management.py +0 -459
- python_hwpx-6.11.0/tests/test_part_hierarchy_read_models.py +0 -250
- python_hwpx-6.11.0/tests/test_picture_adjustments.py +0 -256
- python_hwpx-6.11.0/tests/test_polygon_authoring.py +0 -368
- python_hwpx-6.11.0/tests/test_product_boundary.py +0 -917
- python_hwpx-6.11.0/tests/test_public_artifact_hygiene.py +0 -570
- python_hwpx-6.11.0/tests/test_public_runtime_boundary.py +0 -12
- python_hwpx-6.11.0/tests/test_read_fidelity.py +0 -170
- python_hwpx-6.11.0/tests/test_recover_broken_zip.py +0 -332
- python_hwpx-6.11.0/tests/test_redline_authoring.py +0 -349
- python_hwpx-6.11.0/tests/test_redline_verify.py +0 -130
- python_hwpx-6.11.0/tests/test_release_workflow_safety.py +0 -1182
- python_hwpx-6.11.0/tests/test_remove_unused_charts.py +0 -104
- python_hwpx-6.11.0/tests/test_remove_unused_images.py +0 -84
- python_hwpx-6.11.0/tests/test_repair_repack.py +0 -347
- python_hwpx-6.11.0/tests/test_replace_text_barriers.py +0 -113
- python_hwpx-6.11.0/tests/test_report_utils.py +0 -56
- python_hwpx-6.11.0/tests/test_repr_snapshots.py +0 -68
- python_hwpx-6.11.0/tests/test_return_contract.py +0 -523
- python_hwpx-6.11.0/tests/test_roundtrip_fidelity.py +0 -92
- python_hwpx-6.11.0/tests/test_roundtrip_fidelity_corpus.py +0 -47
- python_hwpx-6.11.0/tests/test_row_heights.py +0 -76
- python_hwpx-6.11.0/tests/test_run_choice_atom_authoring.py +0 -174
- python_hwpx-6.11.0/tests/test_run_content_kinds.py +0 -117
- python_hwpx-6.11.0/tests/test_run_font_refs.py +0 -53
- python_hwpx-6.11.0/tests/test_run_style_base.py +0 -100
- python_hwpx-6.11.0/tests/test_safe_edit_example.py +0 -129
- python_hwpx-6.11.0/tests/test_save_keeps_inline_text_caches.py +0 -78
- python_hwpx-6.11.0/tests/test_save_pipeline.py +0 -322
- python_hwpx-6.11.0/tests/test_save_verifies_once.py +0 -62
- python_hwpx-6.11.0/tests/test_section_clear_body.py +0 -611
- python_hwpx-6.11.0/tests/test_section_columns.py +0 -247
- python_hwpx-6.11.0/tests/test_section_headers.py +0 -383
- python_hwpx-6.11.0/tests/test_section_ids_order.py +0 -136
- python_hwpx-6.11.0/tests/test_section_properties_real_roundtrip.py +0 -101
- python_hwpx-6.11.0/tests/test_set_column_widths_uniform_split.py +0 -65
- python_hwpx-6.11.0/tests/test_set_paragraph_format_keep.py +0 -73
- python_hwpx-6.11.0/tests/test_shape_geometry_contract.py +0 -353
- python_hwpx-6.11.0/tests/test_shape_open_safety_risk_check.py +0 -164
- python_hwpx-6.11.0/tests/test_shape_original_size.py +0 -167
- python_hwpx-6.11.0/tests/test_shape_position_frames.py +0 -355
- python_hwpx-6.11.0/tests/test_shape_size_values.py +0 -212
- python_hwpx-6.11.0/tests/test_size_ratchet.py +0 -102
- python_hwpx-6.11.0/tests/test_skeleton_template_ids.py +0 -25
- python_hwpx-6.11.0/tests/test_split_cell.py +0 -229
- python_hwpx-6.11.0/tests/test_split_merged_cell.py +0 -188
- python_hwpx-6.11.0/tests/test_stable_surface.py +0 -357
- python_hwpx-6.11.0/tests/test_stale_layout_cache_sweep.py +0 -197
- python_hwpx-6.11.0/tests/test_story_edits_reach_control_copy.py +0 -256
- python_hwpx-6.11.0/tests/test_style_font_border_reads.py +0 -830
- python_hwpx-6.11.0/tests/test_style_resolution.py +0 -348
- python_hwpx-6.11.0/tests/test_styles_definition_verbs.py +0 -98
- python_hwpx-6.11.0/tests/test_tab_character_writing.py +0 -107
- python_hwpx-6.11.0/tests/test_tab_definition_version_switch.py +0 -230
- python_hwpx-6.11.0/tests/test_table_cell_equalize.py +0 -93
- python_hwpx-6.11.0/tests/test_table_cleanup.py +0 -49
- python_hwpx-6.11.0/tests/test_table_clone_identities.py +0 -210
- python_hwpx-6.11.0/tests/test_table_column_floor.py +0 -119
- python_hwpx-6.11.0/tests/test_table_label.py +0 -150
- python_hwpx-6.11.0/tests/test_table_navigation.py +0 -242
- python_hwpx-6.11.0/tests/test_table_ops_cells_without_geometry.py +0 -61
- python_hwpx-6.11.0/tests/test_table_ops_delete_every_line.py +0 -44
- python_hwpx-6.11.0/tests/test_table_ops_delete_zones.py +0 -74
- python_hwpx-6.11.0/tests/test_table_page_flow.py +0 -57
- python_hwpx-6.11.0/tests/test_table_patch.py +0 -602
- python_hwpx-6.11.0/tests/test_table_patch_dryrun.py +0 -64
- python_hwpx-6.11.0/tests/test_table_patch_m105.py +0 -271
- python_hwpx-6.11.0/tests/test_table_patch_structure_fixes.py +0 -224
- python_hwpx-6.11.0/tests/test_table_split_merge.py +0 -258
- python_hwpx-6.11.0/tests/test_table_structure_edits.py +0 -378
- python_hwpx-6.11.0/tests/test_tables_default_border.py +0 -81
- python_hwpx-6.11.0/tests/test_template_analyzer_enrichment.py +0 -97
- python_hwpx-6.11.0/tests/test_text_box_fields.py +0 -87
- python_hwpx-6.11.0/tests/test_text_extractor_annotations.py +0 -126
- python_hwpx-6.11.0/tests/test_text_extractor_nested_once.py +0 -107
- python_hwpx-6.11.0/tests/test_text_extractor_run_choice_atoms.py +0 -160
- python_hwpx-6.11.0/tests/test_text_inline_elements.py +0 -180
- python_hwpx-6.11.0/tests/test_text_replace_everywhere.py +0 -211
- python_hwpx-6.11.0/tests/test_title_mark.py +0 -133
- python_hwpx-6.11.0/tests/test_toc_author.py +0 -304
- python_hwpx-6.11.0/tests/test_toc_fidelity.py +0 -250
- python_hwpx-6.11.0/tests/test_tracked_overlap_render_smoke.py +0 -112
- python_hwpx-6.11.0/tests/test_tracked_paragraph_delete_break.py +0 -47
- python_hwpx-6.11.0/tests/test_trailing_table_text.py +0 -153
- python_hwpx-6.11.0/tests/test_validation_severity.py +0 -52
- python_hwpx-6.11.0/tests/test_validator_comment_nodes.py +0 -56
- python_hwpx-6.11.0/tests/test_validator_form_parameters.py +0 -96
- python_hwpx-6.11.0/tests/test_validator_full_schema.py +0 -152
- python_hwpx-6.11.0/tests/test_validator_hancom_open_rules.py +0 -313
- python_hwpx-6.11.0/tests/test_validator_section_ids.py +0 -141
- python_hwpx-6.11.0/tests/test_version_metadata.py +0 -34
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/LICENSE +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/NOTICE +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/setup.cfg +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/__init__.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/__init__.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/_trailing_table_text.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/data/Skeleton.hwpx +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/apply.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/engine.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/policy.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/report.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/__init__.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/binary.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/bodytext.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/controls.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/errors.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/fileheader.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_common.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/shapes.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/writer.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/layout/__init__.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/layout/report.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/objects/tracked.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/opc/relationships.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/body.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/canonical_defaults.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/color.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/common.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_compat.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/history_part.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/master_page.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/parser.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/schema.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/settings.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/oxml/version_part.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/package.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/plan/__init__.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/plan/_execute.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/plan/_model.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/plan/_schema.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/plan/_validate.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/py.typed +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/quality/ledger.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/quality/rendering.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/quality/report.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/header.xsd +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-body.xsd +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-core.xsd +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-header.xsd +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-paralist.xsd +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-xml.xsd +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/section.xsd +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/id_integrity.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/idempotence.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/package_reconcile.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/read_fidelity.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/hwpx/tools/roundtrip_diff.py +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/dependency_links.txt +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/entry_points.txt +0 -0
- {python_hwpx-6.11.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/top_level.txt +0 -0
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# sdist 구성. setuptools는 기본으로 tests/test*.py를 sdist에 싣는데, 그 테스트들이
|
|
2
|
+
# 기대는 fixtures·conftest·스크립트는 실리지 않아 sdist만으로는 돌릴 수 없었다
|
|
3
|
+
# (6.12.0: 테스트 310개). 테스트는 저장소에서 돌리고 sdist에서는 뺀다.
|
|
4
|
+
#
|
|
5
|
+
# CHANGELOG.md는 아직 싣지 않는다. 옛 항목에 내부 작업 번호가 남아 있어
|
|
6
|
+
# scripts/check_public_hygiene.py의 배포본 검사가 막는다. 그 항목을 정리한 뒤
|
|
7
|
+
# `include CHANGELOG.md`를 더한다.
|
|
8
|
+
prune tests
|
|
@@ -1,14 +1,16 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: python-hwpx
|
|
3
|
-
Version:
|
|
3
|
+
Version: 7.0.0
|
|
4
4
|
Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리
|
|
5
5
|
Author: python-hwpx Maintainers
|
|
6
6
|
License-Expression: Apache-2.0
|
|
7
7
|
Project-URL: Homepage, https://github.com/airmang/python-hwpx
|
|
8
8
|
Project-URL: Documentation, https://airmang.github.io/python-hwpx/
|
|
9
9
|
Project-URL: Issues, https://github.com/airmang/python-hwpx/issues
|
|
10
|
+
Project-URL: Changelog, https://github.com/airmang/python-hwpx/blob/main/CHANGELOG.md
|
|
11
|
+
Project-URL: Migration to 7.0, https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md
|
|
10
12
|
Keywords: hwp,hwpx,hancom,opc,xml,document-automation,validation,template
|
|
11
|
-
Classifier: Development Status ::
|
|
13
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
12
14
|
Classifier: Intended Audience :: Developers
|
|
13
15
|
Classifier: Programming Language :: Python :: 3
|
|
14
16
|
Classifier: Programming Language :: Python :: 3.10
|
|
@@ -26,18 +28,24 @@ License-File: NOTICE
|
|
|
26
28
|
Requires-Dist: lxml<7,>=4.9
|
|
27
29
|
Provides-Extra: visual
|
|
28
30
|
Provides-Extra: xlsx
|
|
29
|
-
Requires-Dist: openpyxl>=3.1; extra == "xlsx"
|
|
30
31
|
Provides-Extra: preview
|
|
31
|
-
|
|
32
|
+
Provides-Extra: langchain
|
|
33
|
+
Provides-Extra: llamaindex
|
|
32
34
|
Provides-Extra: dev
|
|
33
35
|
Requires-Dist: build>=1.0; extra == "dev"
|
|
34
36
|
Requires-Dist: twine>=4.0; extra == "dev"
|
|
37
|
+
Requires-Dist: numpy>=1.26; extra == "dev"
|
|
38
|
+
Requires-Dist: pillow>=10.0; extra == "dev"
|
|
35
39
|
Requires-Dist: pytest>=7.4; extra == "dev"
|
|
40
|
+
Requires-Dist: pytest-cov>=5.0; extra == "dev"
|
|
41
|
+
Requires-Dist: pyyaml<7,>=6.0; extra == "dev"
|
|
42
|
+
Requires-Dist: ruff>=0.12; extra == "dev"
|
|
36
43
|
Requires-Dist: latex2mathml>=3.77; extra == "dev"
|
|
44
|
+
Requires-Dist: mypy>=1.10; extra == "dev"
|
|
45
|
+
Requires-Dist: pyright>=1.1.390; extra == "dev"
|
|
37
46
|
Provides-Extra: test
|
|
38
47
|
Requires-Dist: build>=1.0; extra == "test"
|
|
39
48
|
Requires-Dist: numpy>=1.26; extra == "test"
|
|
40
|
-
Requires-Dist: openpyxl>=3.1; extra == "test"
|
|
41
49
|
Requires-Dist: pillow>=10.0; extra == "test"
|
|
42
50
|
Requires-Dist: pytest>=7.4; extra == "test"
|
|
43
51
|
Requires-Dist: pytest-cov>=5.0; extra == "test"
|
|
@@ -64,11 +72,11 @@ Dynamic: license-file
|
|
|
64
72
|
</p>
|
|
65
73
|
</p>
|
|
66
74
|
|
|
67
|
-
<p align="center">한국어 | <a href="README_EN.md">English</a></p>
|
|
75
|
+
<p align="center">한국어 | <a href="https://github.com/airmang/python-hwpx/blob/main/README_EN.md">English</a></p>
|
|
68
76
|
|
|
69
77
|
HWPX는 ZIP 안에 XML(OWPML)을 담은 형식이라, 한컴오피스가 없어도 파이썬만으로 다룰 수 있습니다.
|
|
70
78
|
python-hwpx는 Windows·macOS·Linux·CI 어디서나 돌고 의존성은 `lxml` 하나입니다. HWP 5.0(`.hwp`)도 같은
|
|
71
|
-
API로
|
|
79
|
+
API로 열어 HWPX로 바꿉니다.
|
|
72
80
|
|
|
73
81
|
만든 문서는 한컴오피스 2024에서 직접 열어 보고 그 결과를 날짜와 함께
|
|
74
82
|
[아래](#한글과-얼마나-같은가)에 적어 둡니다.
|
|
@@ -87,68 +95,95 @@ from hwpx import HwpxDocument
|
|
|
87
95
|
doc = HwpxDocument.new()
|
|
88
96
|
doc.add_heading("2026 운영계획", level=1)
|
|
89
97
|
doc.add_paragraph("추진 배경", style="개요 2") # 한/글이 "가." 번호를 붙인다
|
|
90
|
-
doc.
|
|
98
|
+
doc.save("계획.hwpx")
|
|
91
99
|
```
|
|
92
100
|
|
|
93
101
|
스타일은 이름으로 고릅니다. 없는 이름을 쓰면 그 줄에서 바로 오류가 납니다.
|
|
94
102
|
있는 문서를 고칠 때는 `HwpxDocument.open("보고서.hwpx")`로 시작합니다. `.hwp`도 똑같이 열고,
|
|
95
|
-
`
|
|
103
|
+
고친 결과는 `save("보고서.hwpx")`로 HWPX로 저장합니다.
|
|
96
104
|
|
|
97
|
-
|
|
98
|
-
|
|
105
|
+
글자 크기·정렬과 표 칸은 그 자리에서 읽고 고칩니다. 표 칸·머리말·각주까지 문서의 모든 문단을 자리와 함께
|
|
106
|
+
훑을 수 있습니다.
|
|
107
|
+
|
|
108
|
+
<!-- standalone-python-example -->
|
|
109
|
+
|
|
110
|
+
```python
|
|
111
|
+
from hwpx import HwpxDocument
|
|
112
|
+
|
|
113
|
+
doc = HwpxDocument.new()
|
|
114
|
+
title = doc.add_paragraph("2026 운영계획")
|
|
115
|
+
title.alignment = "CENTER"
|
|
116
|
+
title.runs[-1].size = 16
|
|
117
|
+
table = doc.add_table(2, 2)
|
|
118
|
+
table.cell(0, 0).text = "기간"
|
|
119
|
+
table.cell(0, 1).text = "3월 ~ 7월"
|
|
120
|
+
for place in doc.text.iter_paragraphs(where={"cell"}):
|
|
121
|
+
print(place.row, place.col, place.paragraph.text)
|
|
122
|
+
doc.save("계획.hwpx")
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Markdown·HTML 변환, 이름표로 양식 칸 찾기, 메일 머지, 미리보기, 문서 저작·시험지 조판 같은 상위 워크플로는
|
|
126
|
+
7.0부터 [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)에 있습니다
|
|
127
|
+
(`pip install -U python-hwpx-automation`). 이 패키지는 파일에 적힌 대로 읽고 씁니다.
|
|
128
|
+
|
|
129
|
+
6.x에서 올라온다면 [7.0 이주 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md)에 바뀐 이름과 새 자리가 모두 있습니다. 없어진 이름을 부르면
|
|
130
|
+
오류가 새 이름을 알려 줍니다.
|
|
99
131
|
|
|
100
132
|
> 예전 설치 명령을 위해 `pip install "python-hwpx[visual]"`도 계속 됩니다. 다만 이 extra는 비어 있어
|
|
101
133
|
> 렌더·PDF 의존성을 설치하지 않습니다. 그 일은 `python-hwpx-automation[oracle]`이 맡습니다.
|
|
102
134
|
|
|
103
135
|
## 할 수 있는 것
|
|
104
136
|
|
|
105
|
-
- 읽기·추출:
|
|
137
|
+
- 읽기·추출: 한/글의 텍스트 저장처럼 평문으로 내보냅니다(`doc.text.plain()`, 목록 번호·각주 포함 선택).
|
|
138
|
+
`doc.text.outline()`은 글 덩어리를 id와 함께 글자 예산 안에서 돌려주고, `doc.text.iter_paragraphs()`는 표 칸·글상자·
|
|
139
|
+
머리말·각주의 문단까지 자리와 함께 내놓습니다. `.hwp`도 같은 호출로 읽습니다
|
|
140
|
+
([사용법](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md#ai-파이프라인에서-읽기)).
|
|
106
141
|
- 편집: 문단·표·그림·머리말/꼬리말·메모·각주, 줄 간격·여백·쪽 번호 같은 서식을 고칩니다.
|
|
107
|
-
- 양식 채우기:
|
|
142
|
+
- 양식 채우기: 칸·누름틀에 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
|
|
108
143
|
칸에 들어가도록 줄을 바꾸거나 글자를 줄일지 한/글의 글자 폭으로 재서 고릅니다.
|
|
109
144
|
- 표 구조 편집: 행·열 넣기와 지우기, 칸 나누기와 합치기. `doc.tables[0]`처럼 번호로 표를 꺼냅니다.
|
|
110
|
-
- 만들기·일괄 처리: 새 문서, 목차·상호 참조,
|
|
111
|
-
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고
|
|
112
|
-
`document.conversion_report`에 남습니다.
|
|
145
|
+
- 만들기·일괄 처리: 새 문서, 목차·상호 참조, 문서 비교, 변경 추적.
|
|
146
|
+
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고 HWPX로 저장합니다. 옮기지 못한 내용은
|
|
147
|
+
`document.conversion_report`에 남습니다. `.hwp`로 다시 쓰는 기능은 실험입니다. 연 원본을 덮어쓰지 않고,
|
|
148
|
+
옮기지 못한 내용이 있으면 쓰지 않습니다.
|
|
113
149
|
- 배치 추정(실험): `estimate_pages`는 한/글 없이 쪽 수와 줄마다의 쪽·세로 위치를 추정합니다.
|
|
114
150
|
`write_line_caches`는 한/글이 저장할 때 쓰는 줄 배치 정보를, 한/글과 같은 값을 확실히 아는 문단에만 씁니다.
|
|
115
151
|
rhwp처럼 이 정보로 그림 자리를 찾는 뷰어에서도 그림이 보이게 됩니다. 기본으로는 쓰지 않습니다.
|
|
116
|
-
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`
|
|
152
|
+
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`save()`가 돌려주는 `MutationReport`). 기본 저장은 없는 글자 모양·
|
|
153
|
+
문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `save(..., quality=QualityPolicy(require_visual_complete=False))`가 합니다
|
|
154
|
+
([검사 범위](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md#변경-사항-저장과-결과물-확인)).
|
|
117
155
|
|
|
118
|
-
자세한 내용: [5분 퀵스타트](docs/quickstart.md) · [사용 가이드](docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [예제](docs/examples.md) · [지원 매트릭스](docs/support-matrix.md)
|
|
156
|
+
자세한 내용: [5분 퀵스타트](https://github.com/airmang/python-hwpx/blob/main/docs/quickstart.md) · [사용 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [예제](https://github.com/airmang/python-hwpx/blob/main/docs/examples.md) · [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md)
|
|
119
157
|
|
|
120
158
|
### 양식 채우기 예
|
|
121
159
|
|
|
122
160
|
```python
|
|
123
161
|
doc = HwpxDocument.open("신청서.hwpx")
|
|
124
|
-
|
|
125
|
-
"
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
if result["failed_count"] or result["applied_count"] != len(values):
|
|
130
|
-
raise ValueError(result["failed"])
|
|
131
|
-
report = doc.save_to_path("신청서-작성완료.hwpx", mode="patch", fallback="error", return_report=True)
|
|
162
|
+
for cell in doc.tables.map()["tables"][0]["cells"]: # 표의 칸마다 행·열과 글
|
|
163
|
+
print(cell["row"], cell["col"], cell["text"]) # 0 0 성 명 / 0 1 (빈 칸) ...
|
|
164
|
+
doc.tables[0].cell(0, 1).text = "홍길동"
|
|
165
|
+
doc.tables[0].cell(1, 1).text = "플랫폼팀"
|
|
166
|
+
report = doc.save("신청서-작성완료.hwpx", mode="patch", fallback="error")
|
|
132
167
|
```
|
|
133
168
|
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
169
|
+
`mode="patch"`는 고치지 않은 ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고치지 않은 파트는 압축된 바이트까지
|
|
170
|
+
원본 그대로 옮기고, 아무것도 고치지 않은 저장은 파일째 같습니다(커서가 없는 문단을 가리키는 문서는 `settings.xml`의 커서 자리만 고쳐 씁니다). 고친 파트는 내용이 결정적이지만 압축된 바이트는
|
|
171
|
+
Python이 쓰는 zlib 구현에 따라 다를 수 있습니다. 고친 파트 안쪽과 화면 배치는 따로
|
|
172
|
+
확인해야 합니다. 저장한 파일을 다시 열어 내용까지 확인하는 방법은 [안전한 쓰기 계약](https://github.com/airmang/python-hwpx/blob/main/docs/safe-write-contract.md)에
|
|
173
|
+
있습니다. 이름표 글자로 칸을 찾아 채우는 `fill_by_path`는 python-hwpx-automation(`hwpx_automation.forms`)에 있습니다.
|
|
174
|
+
|
|
175
|
+
`doc.tables.map()`이 매긴 표 번호(`table_index`)는 칸 안의 표까지 센 번호라 `doc.tables.with_nested`의 번호와 같습니다.
|
|
176
|
+
`doc.tables`는 칸 안의 표를 세지 않으므로, 칸 안에 표가 있는 양식에서는 `doc.tables.with_nested[table_index]`로 고르세요.
|
|
177
|
+
합친 칸은 덮는 자리마다 같은 글로 한 번씩 나옵니다.
|
|
137
178
|
|
|
138
179
|
*독립 실행 예제로 표시하지 않은 블록은 여러분이 가진 문서를 입력으로 쓰는 조각입니다. 예제별 Python 블록 판정은
|
|
139
|
-
[실행 기록](docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
180
|
+
[실행 기록](https://github.com/airmang/python-hwpx/blob/main/docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
140
181
|
|
|
141
182
|
## 한/글과 얼마나 같은가
|
|
142
183
|
|
|
143
184
|
만든 파일을 실제 한컴오피스로 열어 보고 그대로 적습니다. 숫자마다 잰 날짜와 프로그램 판을 붙입니다.
|
|
144
185
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
| 무엇을 | 정답 | 결과 |
|
|
148
|
-
|---|---|---|
|
|
149
|
-
| 공개 실문서 77건의 줄 나눔이 같은 문단 | 한컴오피스 2024 (Windows)가 배치해 저장한 것 | 8,246 / 8,263 (99.8 %) |
|
|
150
|
-
| 그 77건 중 모든 줄의 쪽·위치가 같은 문서 | 같음 | 76 / 77 (나머지 1건은 표가 깨진 문서) |
|
|
151
|
-
| 줄 배치 정보를 지운 사본으로 추정한 쪽 수가 같은 문서 (공개 79 · 비공개 실문서 522 · 기능 시험 문서 780) | 그 문서를 저장한 한/글의 쪽 수 | 1,344 / 1,381 (추정하지 않음 16) |
|
|
186
|
+
줄 배치와 쪽 수 추정은 실험 기능입니다. 정확도 숫자는 측정 스크립트와 기록을 저장소에 함께 실을 수 있을 때 적습니다.
|
|
152
187
|
|
|
153
188
|
**열림: 한컴오피스 12 (macOS)**
|
|
154
189
|
|
|
@@ -164,10 +199,10 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
164
199
|
<p align="center"><sub>ChatGPT 실행 환경에서 만든 문서를 실제 한컴오피스로 연 모습.</sub></p>
|
|
165
200
|
|
|
166
201
|
전체 숫자와 주의할 점은 [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)에,
|
|
167
|
-
기능별 등급은 [지원 매트릭스](docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
202
|
+
기능별 등급은 [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
168
203
|
받는가"를 잰 것이고 파서가 문서를 얼마나 잘 읽는지와는 다른 지표입니다.
|
|
169
204
|
|
|
170
|
-
개발 단계는
|
|
205
|
+
개발 단계는 안정(Production/Stable)입니다. 하위 호환을 지키는 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)에 적혀 있고,
|
|
171
206
|
`hwpx.experimental`과 위에서 "실험"이라고 적은 기능은 바뀔 수 있습니다.
|
|
172
207
|
|
|
173
208
|
## 어디서 쓰나
|
|
@@ -175,8 +210,8 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
175
210
|
| 환경 | 방법 |
|
|
176
211
|
|---|---|
|
|
177
212
|
| 로컬·서버 파이썬 | `pip install python-hwpx` (스크립트·배치·CI) |
|
|
178
|
-
| 파이썬 자동화 (MCP 없이) | `pip install python-hwpx-automation` (저작·양식 채움·검증 워크플로) |
|
|
179
|
-
| 일반 ChatGPT 대화 | `.hwpx`와 [Release wheel](https://github.com/airmang/python-hwpx/releases/latest)을 함께 올려 대화 안에서 설치([안내](docs/ai-assistants.md)) |
|
|
213
|
+
| 파이썬 자동화 (MCP 없이) | `pip install -U python-hwpx-automation` (저작·양식 채움·검증 워크플로) |
|
|
214
|
+
| 일반 ChatGPT 대화 | `.hwpx`와 [Release wheel](https://github.com/airmang/python-hwpx/releases/latest)을 함께 올려 대화 안에서 설치([안내](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)) |
|
|
180
215
|
| ChatGPT MCP 앱 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)의 MCP adapter를 커넥터로 등록 |
|
|
181
216
|
| Codex 마켓플레이스 플러그인 | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) 설치 |
|
|
182
217
|
| Claude Code · Hermes · OpenClaw | 같은 MCP 서버를 각 클라이언트에 등록 ([`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)) |
|
|
@@ -196,7 +231,7 @@ ChatGPT 채팅의 파이썬 환경은 PyPI에 접속하지 못합니다. 그래
|
|
|
196
231
|
```
|
|
197
232
|
|
|
198
233
|
설치부터 결과 파일까지 대화 안에서 끝나므로 내 컴퓨터에 파이썬이 없어도 됩니다. wheel의 의존성은 `lxml`
|
|
199
|
-
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](docs/ai-assistants.md)에,
|
|
234
|
+
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)에,
|
|
200
235
|
AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.github.io/python-hwpx/llms.txt)도 있습니다.
|
|
201
236
|
|
|
202
237
|
| | 저장소 | 역할 |
|
|
@@ -209,19 +244,19 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
209
244
|
|
|
210
245
|
| | python-hwpx | pyhwpx | pyhwp |
|
|
211
246
|
|---|---|---|---|
|
|
212
|
-
| **다루는 형식** | `.hwpx
|
|
247
|
+
| **다루는 형식** | `.hwpx` 읽기·쓰기, `.hwp` (HWP 5.0) 읽기 | `.hwpx` | `.hwp` (v5 바이너리) |
|
|
213
248
|
| **한/글 설치** | 필요 없음 | 필요 (Windows COM) | 필요 없음 |
|
|
214
249
|
| **운영체제** | Linux / macOS / Windows / CI | Windows 전용 | Linux / macOS / Windows |
|
|
215
250
|
| **편집·생성** | ✅ | ✅ (한/글이 함) | 대부분 읽기 |
|
|
216
251
|
| **한/글 없이 쪽 수 추정** | ✅ (실험) | 한/글이 계산 | ❌ |
|
|
217
|
-
| **AI 에이전트 연동 (MCP)** | ✅ (automation 경유) | ❌ | ❌ |
|
|
218
252
|
|
|
219
253
|
## 알려진 제약
|
|
220
254
|
|
|
221
|
-
- `add_shape()
|
|
222
|
-
경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는
|
|
223
|
-
`
|
|
224
|
-
`
|
|
255
|
+
- `doc.shapes.add_raw()`(옛 이름 `add_shape()`)·`doc.shapes.add_control()`은 저수준 탈출구라, 그대로 저장하면
|
|
256
|
+
한/글이 열지 못하는 파일이 됩니다(부를 때 경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는
|
|
257
|
+
`doc.shapes`의 `add_line()`·`add_rectangle()`·`add_ellipse()`·`add_arc()`·`add_polygon()`·`add_curve()`·
|
|
258
|
+
`add_connector()`·`add_container()`(묶음)를, 컨트롤은 문단의 `add_column_definition()`과
|
|
259
|
+
`doc.refs.add_bookmark()`·`doc.refs.add_hyperlink()`를 쓰세요.
|
|
225
260
|
- 그림은 밝기·대비·회색조·흑백·투명도, 실선 테두리, 자르기(`crop`), 그림자·빛남·부드러운 가장자리·반사
|
|
226
261
|
(`shadow`·`glow`·`soft_edge`·`reflection`)를 `add_picture()` 인자로 줄 수 있습니다. 뒤집기와 회전은 아직 안 됩니다.
|
|
227
262
|
- 쪽 수 추정과 줄 배치 정보 쓰기는 실험 기능입니다. 따르지 못하는 요소가 있으면 추정하지 않고 까닭을 돌려줍니다.
|
|
@@ -235,11 +270,11 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
235
270
|
[help wanted](https://github.com/airmang/python-hwpx/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) ·
|
|
236
271
|
[로드맵](https://github.com/airmang/python-hwpx/milestones) ·
|
|
237
272
|
[Discussions](https://github.com/airmang/python-hwpx/discussions) ·
|
|
238
|
-
[CONTRIBUTING](CONTRIBUTING.md)
|
|
273
|
+
[CONTRIBUTING](https://github.com/airmang/python-hwpx/blob/main/CONTRIBUTING.md)
|
|
239
274
|
|
|
240
|
-
HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals
|
|
241
|
-
캐시, 목차 필드, OPC 재압축 같은 내용을 정리해 두었습니다. 공개 API의 안정 범위는 [안정 API 표면](docs/stable-api.md),
|
|
242
|
-
계층 사이의 소유권은 [제품 경계 문서](docs/architecture/product-boundary.md)에 있습니다.
|
|
275
|
+
HWPX 내부 구조가 처음이라면 [내부 실전 가이드](https://github.com/airmang/python-hwpx/tree/main/docs/internals)부터 보세요. 실제 한/글 동작으로 확인한 조판
|
|
276
|
+
캐시, 목차 필드, OPC 재압축 같은 내용을 정리해 두었습니다. 공개 API의 안정 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md),
|
|
277
|
+
계층 사이의 소유권은 [제품 경계 문서](https://github.com/airmang/python-hwpx/blob/main/docs/architecture/product-boundary.md)에 있습니다.
|
|
243
278
|
|
|
244
279
|
## 감사의 말
|
|
245
280
|
|
|
@@ -253,4 +288,4 @@ HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals/)
|
|
|
253
288
|
|
|
254
289
|
## License · Maintainer
|
|
255
290
|
|
|
256
|
-
Apache-2.0 ([LICENSE](LICENSE) · [NOTICE](NOTICE)) · Kohkyuhyun [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
|
|
291
|
+
Apache-2.0 ([LICENSE](https://github.com/airmang/python-hwpx/blob/main/LICENSE) · [NOTICE](https://github.com/airmang/python-hwpx/blob/main/NOTICE)) · Kohkyuhyun [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
|
|
@@ -13,11 +13,11 @@
|
|
|
13
13
|
</p>
|
|
14
14
|
</p>
|
|
15
15
|
|
|
16
|
-
<p align="center">한국어 | <a href="README_EN.md">English</a></p>
|
|
16
|
+
<p align="center">한국어 | <a href="https://github.com/airmang/python-hwpx/blob/main/README_EN.md">English</a></p>
|
|
17
17
|
|
|
18
18
|
HWPX는 ZIP 안에 XML(OWPML)을 담은 형식이라, 한컴오피스가 없어도 파이썬만으로 다룰 수 있습니다.
|
|
19
19
|
python-hwpx는 Windows·macOS·Linux·CI 어디서나 돌고 의존성은 `lxml` 하나입니다. HWP 5.0(`.hwp`)도 같은
|
|
20
|
-
API로
|
|
20
|
+
API로 열어 HWPX로 바꿉니다.
|
|
21
21
|
|
|
22
22
|
만든 문서는 한컴오피스 2024에서 직접 열어 보고 그 결과를 날짜와 함께
|
|
23
23
|
[아래](#한글과-얼마나-같은가)에 적어 둡니다.
|
|
@@ -36,68 +36,95 @@ from hwpx import HwpxDocument
|
|
|
36
36
|
doc = HwpxDocument.new()
|
|
37
37
|
doc.add_heading("2026 운영계획", level=1)
|
|
38
38
|
doc.add_paragraph("추진 배경", style="개요 2") # 한/글이 "가." 번호를 붙인다
|
|
39
|
-
doc.
|
|
39
|
+
doc.save("계획.hwpx")
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
스타일은 이름으로 고릅니다. 없는 이름을 쓰면 그 줄에서 바로 오류가 납니다.
|
|
43
43
|
있는 문서를 고칠 때는 `HwpxDocument.open("보고서.hwpx")`로 시작합니다. `.hwp`도 똑같이 열고,
|
|
44
|
-
`
|
|
44
|
+
고친 결과는 `save("보고서.hwpx")`로 HWPX로 저장합니다.
|
|
45
45
|
|
|
46
|
-
|
|
47
|
-
|
|
46
|
+
글자 크기·정렬과 표 칸은 그 자리에서 읽고 고칩니다. 표 칸·머리말·각주까지 문서의 모든 문단을 자리와 함께
|
|
47
|
+
훑을 수 있습니다.
|
|
48
|
+
|
|
49
|
+
<!-- standalone-python-example -->
|
|
50
|
+
|
|
51
|
+
```python
|
|
52
|
+
from hwpx import HwpxDocument
|
|
53
|
+
|
|
54
|
+
doc = HwpxDocument.new()
|
|
55
|
+
title = doc.add_paragraph("2026 운영계획")
|
|
56
|
+
title.alignment = "CENTER"
|
|
57
|
+
title.runs[-1].size = 16
|
|
58
|
+
table = doc.add_table(2, 2)
|
|
59
|
+
table.cell(0, 0).text = "기간"
|
|
60
|
+
table.cell(0, 1).text = "3월 ~ 7월"
|
|
61
|
+
for place in doc.text.iter_paragraphs(where={"cell"}):
|
|
62
|
+
print(place.row, place.col, place.paragraph.text)
|
|
63
|
+
doc.save("계획.hwpx")
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Markdown·HTML 변환, 이름표로 양식 칸 찾기, 메일 머지, 미리보기, 문서 저작·시험지 조판 같은 상위 워크플로는
|
|
67
|
+
7.0부터 [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)에 있습니다
|
|
68
|
+
(`pip install -U python-hwpx-automation`). 이 패키지는 파일에 적힌 대로 읽고 씁니다.
|
|
69
|
+
|
|
70
|
+
6.x에서 올라온다면 [7.0 이주 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md)에 바뀐 이름과 새 자리가 모두 있습니다. 없어진 이름을 부르면
|
|
71
|
+
오류가 새 이름을 알려 줍니다.
|
|
48
72
|
|
|
49
73
|
> 예전 설치 명령을 위해 `pip install "python-hwpx[visual]"`도 계속 됩니다. 다만 이 extra는 비어 있어
|
|
50
74
|
> 렌더·PDF 의존성을 설치하지 않습니다. 그 일은 `python-hwpx-automation[oracle]`이 맡습니다.
|
|
51
75
|
|
|
52
76
|
## 할 수 있는 것
|
|
53
77
|
|
|
54
|
-
- 읽기·추출:
|
|
78
|
+
- 읽기·추출: 한/글의 텍스트 저장처럼 평문으로 내보냅니다(`doc.text.plain()`, 목록 번호·각주 포함 선택).
|
|
79
|
+
`doc.text.outline()`은 글 덩어리를 id와 함께 글자 예산 안에서 돌려주고, `doc.text.iter_paragraphs()`는 표 칸·글상자·
|
|
80
|
+
머리말·각주의 문단까지 자리와 함께 내놓습니다. `.hwp`도 같은 호출로 읽습니다
|
|
81
|
+
([사용법](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md#ai-파이프라인에서-읽기)).
|
|
55
82
|
- 편집: 문단·표·그림·머리말/꼬리말·메모·각주, 줄 간격·여백·쪽 번호 같은 서식을 고칩니다.
|
|
56
|
-
- 양식 채우기:
|
|
83
|
+
- 양식 채우기: 칸·누름틀에 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
|
|
57
84
|
칸에 들어가도록 줄을 바꾸거나 글자를 줄일지 한/글의 글자 폭으로 재서 고릅니다.
|
|
58
85
|
- 표 구조 편집: 행·열 넣기와 지우기, 칸 나누기와 합치기. `doc.tables[0]`처럼 번호로 표를 꺼냅니다.
|
|
59
|
-
- 만들기·일괄 처리: 새 문서, 목차·상호 참조,
|
|
60
|
-
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고
|
|
61
|
-
`document.conversion_report`에 남습니다.
|
|
86
|
+
- 만들기·일괄 처리: 새 문서, 목차·상호 참조, 문서 비교, 변경 추적.
|
|
87
|
+
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고 HWPX로 저장합니다. 옮기지 못한 내용은
|
|
88
|
+
`document.conversion_report`에 남습니다. `.hwp`로 다시 쓰는 기능은 실험입니다. 연 원본을 덮어쓰지 않고,
|
|
89
|
+
옮기지 못한 내용이 있으면 쓰지 않습니다.
|
|
62
90
|
- 배치 추정(실험): `estimate_pages`는 한/글 없이 쪽 수와 줄마다의 쪽·세로 위치를 추정합니다.
|
|
63
91
|
`write_line_caches`는 한/글이 저장할 때 쓰는 줄 배치 정보를, 한/글과 같은 값을 확실히 아는 문단에만 씁니다.
|
|
64
92
|
rhwp처럼 이 정보로 그림 자리를 찾는 뷰어에서도 그림이 보이게 됩니다. 기본으로는 쓰지 않습니다.
|
|
65
|
-
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`
|
|
93
|
+
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`save()`가 돌려주는 `MutationReport`). 기본 저장은 없는 글자 모양·
|
|
94
|
+
문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `save(..., quality=QualityPolicy(require_visual_complete=False))`가 합니다
|
|
95
|
+
([검사 범위](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md#변경-사항-저장과-결과물-확인)).
|
|
66
96
|
|
|
67
|
-
자세한 내용: [5분 퀵스타트](docs/quickstart.md) · [사용 가이드](docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [예제](docs/examples.md) · [지원 매트릭스](docs/support-matrix.md)
|
|
97
|
+
자세한 내용: [5분 퀵스타트](https://github.com/airmang/python-hwpx/blob/main/docs/quickstart.md) · [사용 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [예제](https://github.com/airmang/python-hwpx/blob/main/docs/examples.md) · [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md)
|
|
68
98
|
|
|
69
99
|
### 양식 채우기 예
|
|
70
100
|
|
|
71
101
|
```python
|
|
72
102
|
doc = HwpxDocument.open("신청서.hwpx")
|
|
73
|
-
|
|
74
|
-
"
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
if result["failed_count"] or result["applied_count"] != len(values):
|
|
79
|
-
raise ValueError(result["failed"])
|
|
80
|
-
report = doc.save_to_path("신청서-작성완료.hwpx", mode="patch", fallback="error", return_report=True)
|
|
103
|
+
for cell in doc.tables.map()["tables"][0]["cells"]: # 표의 칸마다 행·열과 글
|
|
104
|
+
print(cell["row"], cell["col"], cell["text"]) # 0 0 성 명 / 0 1 (빈 칸) ...
|
|
105
|
+
doc.tables[0].cell(0, 1).text = "홍길동"
|
|
106
|
+
doc.tables[0].cell(1, 1).text = "플랫폼팀"
|
|
107
|
+
report = doc.save("신청서-작성완료.hwpx", mode="patch", fallback="error")
|
|
81
108
|
```
|
|
82
109
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
110
|
+
`mode="patch"`는 고치지 않은 ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고치지 않은 파트는 압축된 바이트까지
|
|
111
|
+
원본 그대로 옮기고, 아무것도 고치지 않은 저장은 파일째 같습니다(커서가 없는 문단을 가리키는 문서는 `settings.xml`의 커서 자리만 고쳐 씁니다). 고친 파트는 내용이 결정적이지만 압축된 바이트는
|
|
112
|
+
Python이 쓰는 zlib 구현에 따라 다를 수 있습니다. 고친 파트 안쪽과 화면 배치는 따로
|
|
113
|
+
확인해야 합니다. 저장한 파일을 다시 열어 내용까지 확인하는 방법은 [안전한 쓰기 계약](https://github.com/airmang/python-hwpx/blob/main/docs/safe-write-contract.md)에
|
|
114
|
+
있습니다. 이름표 글자로 칸을 찾아 채우는 `fill_by_path`는 python-hwpx-automation(`hwpx_automation.forms`)에 있습니다.
|
|
115
|
+
|
|
116
|
+
`doc.tables.map()`이 매긴 표 번호(`table_index`)는 칸 안의 표까지 센 번호라 `doc.tables.with_nested`의 번호와 같습니다.
|
|
117
|
+
`doc.tables`는 칸 안의 표를 세지 않으므로, 칸 안에 표가 있는 양식에서는 `doc.tables.with_nested[table_index]`로 고르세요.
|
|
118
|
+
합친 칸은 덮는 자리마다 같은 글로 한 번씩 나옵니다.
|
|
86
119
|
|
|
87
120
|
*독립 실행 예제로 표시하지 않은 블록은 여러분이 가진 문서를 입력으로 쓰는 조각입니다. 예제별 Python 블록 판정은
|
|
88
|
-
[실행 기록](docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
121
|
+
[실행 기록](https://github.com/airmang/python-hwpx/blob/main/docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
89
122
|
|
|
90
123
|
## 한/글과 얼마나 같은가
|
|
91
124
|
|
|
92
125
|
만든 파일을 실제 한컴오피스로 열어 보고 그대로 적습니다. 숫자마다 잰 날짜와 프로그램 판을 붙입니다.
|
|
93
126
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
| 무엇을 | 정답 | 결과 |
|
|
97
|
-
|---|---|---|
|
|
98
|
-
| 공개 실문서 77건의 줄 나눔이 같은 문단 | 한컴오피스 2024 (Windows)가 배치해 저장한 것 | 8,246 / 8,263 (99.8 %) |
|
|
99
|
-
| 그 77건 중 모든 줄의 쪽·위치가 같은 문서 | 같음 | 76 / 77 (나머지 1건은 표가 깨진 문서) |
|
|
100
|
-
| 줄 배치 정보를 지운 사본으로 추정한 쪽 수가 같은 문서 (공개 79 · 비공개 실문서 522 · 기능 시험 문서 780) | 그 문서를 저장한 한/글의 쪽 수 | 1,344 / 1,381 (추정하지 않음 16) |
|
|
127
|
+
줄 배치와 쪽 수 추정은 실험 기능입니다. 정확도 숫자는 측정 스크립트와 기록을 저장소에 함께 실을 수 있을 때 적습니다.
|
|
101
128
|
|
|
102
129
|
**열림: 한컴오피스 12 (macOS)**
|
|
103
130
|
|
|
@@ -113,10 +140,10 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
113
140
|
<p align="center"><sub>ChatGPT 실행 환경에서 만든 문서를 실제 한컴오피스로 연 모습.</sub></p>
|
|
114
141
|
|
|
115
142
|
전체 숫자와 주의할 점은 [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)에,
|
|
116
|
-
기능별 등급은 [지원 매트릭스](docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
143
|
+
기능별 등급은 [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
117
144
|
받는가"를 잰 것이고 파서가 문서를 얼마나 잘 읽는지와는 다른 지표입니다.
|
|
118
145
|
|
|
119
|
-
개발 단계는
|
|
146
|
+
개발 단계는 안정(Production/Stable)입니다. 하위 호환을 지키는 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)에 적혀 있고,
|
|
120
147
|
`hwpx.experimental`과 위에서 "실험"이라고 적은 기능은 바뀔 수 있습니다.
|
|
121
148
|
|
|
122
149
|
## 어디서 쓰나
|
|
@@ -124,8 +151,8 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
124
151
|
| 환경 | 방법 |
|
|
125
152
|
|---|---|
|
|
126
153
|
| 로컬·서버 파이썬 | `pip install python-hwpx` (스크립트·배치·CI) |
|
|
127
|
-
| 파이썬 자동화 (MCP 없이) | `pip install python-hwpx-automation` (저작·양식 채움·검증 워크플로) |
|
|
128
|
-
| 일반 ChatGPT 대화 | `.hwpx`와 [Release wheel](https://github.com/airmang/python-hwpx/releases/latest)을 함께 올려 대화 안에서 설치([안내](docs/ai-assistants.md)) |
|
|
154
|
+
| 파이썬 자동화 (MCP 없이) | `pip install -U python-hwpx-automation` (저작·양식 채움·검증 워크플로) |
|
|
155
|
+
| 일반 ChatGPT 대화 | `.hwpx`와 [Release wheel](https://github.com/airmang/python-hwpx/releases/latest)을 함께 올려 대화 안에서 설치([안내](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)) |
|
|
129
156
|
| ChatGPT MCP 앱 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)의 MCP adapter를 커넥터로 등록 |
|
|
130
157
|
| Codex 마켓플레이스 플러그인 | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) 설치 |
|
|
131
158
|
| Claude Code · Hermes · OpenClaw | 같은 MCP 서버를 각 클라이언트에 등록 ([`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)) |
|
|
@@ -145,7 +172,7 @@ ChatGPT 채팅의 파이썬 환경은 PyPI에 접속하지 못합니다. 그래
|
|
|
145
172
|
```
|
|
146
173
|
|
|
147
174
|
설치부터 결과 파일까지 대화 안에서 끝나므로 내 컴퓨터에 파이썬이 없어도 됩니다. wheel의 의존성은 `lxml`
|
|
148
|
-
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](docs/ai-assistants.md)에,
|
|
175
|
+
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)에,
|
|
149
176
|
AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.github.io/python-hwpx/llms.txt)도 있습니다.
|
|
150
177
|
|
|
151
178
|
| | 저장소 | 역할 |
|
|
@@ -158,19 +185,19 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
158
185
|
|
|
159
186
|
| | python-hwpx | pyhwpx | pyhwp |
|
|
160
187
|
|---|---|---|---|
|
|
161
|
-
| **다루는 형식** | `.hwpx
|
|
188
|
+
| **다루는 형식** | `.hwpx` 읽기·쓰기, `.hwp` (HWP 5.0) 읽기 | `.hwpx` | `.hwp` (v5 바이너리) |
|
|
162
189
|
| **한/글 설치** | 필요 없음 | 필요 (Windows COM) | 필요 없음 |
|
|
163
190
|
| **운영체제** | Linux / macOS / Windows / CI | Windows 전용 | Linux / macOS / Windows |
|
|
164
191
|
| **편집·생성** | ✅ | ✅ (한/글이 함) | 대부분 읽기 |
|
|
165
192
|
| **한/글 없이 쪽 수 추정** | ✅ (실험) | 한/글이 계산 | ❌ |
|
|
166
|
-
| **AI 에이전트 연동 (MCP)** | ✅ (automation 경유) | ❌ | ❌ |
|
|
167
193
|
|
|
168
194
|
## 알려진 제약
|
|
169
195
|
|
|
170
|
-
- `add_shape()
|
|
171
|
-
경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는
|
|
172
|
-
`
|
|
173
|
-
`
|
|
196
|
+
- `doc.shapes.add_raw()`(옛 이름 `add_shape()`)·`doc.shapes.add_control()`은 저수준 탈출구라, 그대로 저장하면
|
|
197
|
+
한/글이 열지 못하는 파일이 됩니다(부를 때 경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는
|
|
198
|
+
`doc.shapes`의 `add_line()`·`add_rectangle()`·`add_ellipse()`·`add_arc()`·`add_polygon()`·`add_curve()`·
|
|
199
|
+
`add_connector()`·`add_container()`(묶음)를, 컨트롤은 문단의 `add_column_definition()`과
|
|
200
|
+
`doc.refs.add_bookmark()`·`doc.refs.add_hyperlink()`를 쓰세요.
|
|
174
201
|
- 그림은 밝기·대비·회색조·흑백·투명도, 실선 테두리, 자르기(`crop`), 그림자·빛남·부드러운 가장자리·반사
|
|
175
202
|
(`shadow`·`glow`·`soft_edge`·`reflection`)를 `add_picture()` 인자로 줄 수 있습니다. 뒤집기와 회전은 아직 안 됩니다.
|
|
176
203
|
- 쪽 수 추정과 줄 배치 정보 쓰기는 실험 기능입니다. 따르지 못하는 요소가 있으면 추정하지 않고 까닭을 돌려줍니다.
|
|
@@ -184,11 +211,11 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
184
211
|
[help wanted](https://github.com/airmang/python-hwpx/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) ·
|
|
185
212
|
[로드맵](https://github.com/airmang/python-hwpx/milestones) ·
|
|
186
213
|
[Discussions](https://github.com/airmang/python-hwpx/discussions) ·
|
|
187
|
-
[CONTRIBUTING](CONTRIBUTING.md)
|
|
214
|
+
[CONTRIBUTING](https://github.com/airmang/python-hwpx/blob/main/CONTRIBUTING.md)
|
|
188
215
|
|
|
189
|
-
HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals
|
|
190
|
-
캐시, 목차 필드, OPC 재압축 같은 내용을 정리해 두었습니다. 공개 API의 안정 범위는 [안정 API 표면](docs/stable-api.md),
|
|
191
|
-
계층 사이의 소유권은 [제품 경계 문서](docs/architecture/product-boundary.md)에 있습니다.
|
|
216
|
+
HWPX 내부 구조가 처음이라면 [내부 실전 가이드](https://github.com/airmang/python-hwpx/tree/main/docs/internals)부터 보세요. 실제 한/글 동작으로 확인한 조판
|
|
217
|
+
캐시, 목차 필드, OPC 재압축 같은 내용을 정리해 두었습니다. 공개 API의 안정 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md),
|
|
218
|
+
계층 사이의 소유권은 [제품 경계 문서](https://github.com/airmang/python-hwpx/blob/main/docs/architecture/product-boundary.md)에 있습니다.
|
|
192
219
|
|
|
193
220
|
## 감사의 말
|
|
194
221
|
|
|
@@ -202,4 +229,4 @@ HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals/)
|
|
|
202
229
|
|
|
203
230
|
## License · Maintainer
|
|
204
231
|
|
|
205
|
-
Apache-2.0 ([LICENSE](LICENSE) · [NOTICE](NOTICE)) · Kohkyuhyun [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
|
|
232
|
+
Apache-2.0 ([LICENSE](https://github.com/airmang/python-hwpx/blob/main/LICENSE) · [NOTICE](https://github.com/airmang/python-hwpx/blob/main/NOTICE)) · Kohkyuhyun [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
|