python-hwpx 6.12.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.12.0/src/python_hwpx.egg-info → python_hwpx-7.0.0}/PKG-INFO +81 -59
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/README.md +75 -53
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/pyproject.toml +54 -35
- {python_hwpx-6.12.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.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/fields.py +881 -51
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/headings.py +5 -13
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/highlight.py +64 -5
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/layout.py +311 -222
- {python_hwpx-6.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/fields.py +170 -20
- {python_hwpx-6.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/shapes.py +198 -122
- {python_hwpx-6.12.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.12.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.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/capabilities.py +54 -79
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/known-traps.md +29 -12
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/mutation-semantics.md +14 -11
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/recipes-traversal.md +8 -8
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/support-matrix.md +28 -28
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/document.py +431 -266
- 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.12.0 → python_hwpx-7.0.0}/src/hwpx/equation/eqedit.py +163 -15
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/equation/measure.py +208 -42
- {python_hwpx-6.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/__init__.py +7 -1
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/measure.py +4 -2
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/cfb.py +37 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/docinfo.py +8 -6
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/docinfo_writer.py +12 -7
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/header_xml.py +75 -18
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/owpml.py +7 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/package.py +79 -9
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/reader.py +3 -5
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/records.py +19 -5
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_writer.py +21 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_xml.py +170 -30
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/shape_xml.py +2 -2
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/_page_measure.py +10 -3
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/lint.py +5 -5
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/model.py +7 -1
- {python_hwpx-6.12.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-6.12.0 → python_hwpx-7.0.0}/src/hwpx/opc/package.py +925 -142
- 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.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/__init__.py +5 -2
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/_document_impl.py +1 -1
- {python_hwpx-6.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/curves.py +71 -13
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document_metadata.py +52 -4
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document_parts.py +243 -134
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/drop_cap.py +7 -5
- python_hwpx-7.0.0/src/hwpx/oxml/dutmal_compose.py +372 -0
- {python_hwpx-6.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header.py +90 -24
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_fonts.py +180 -33
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_part.py +278 -99
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/hyperlink_form.py +117 -1
- {python_hwpx-6.12.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.12.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.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/objects.py +568 -204
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/paragraph.py +588 -207
- {python_hwpx-6.12.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-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section.py +512 -62
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_format.py +311 -215
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_layout.py +4 -2
- {python_hwpx-6.12.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-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/simple_parts.py +86 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table.py +210 -144
- python_hwpx-7.0.0/src/hwpx/oxml/table_format.py +1048 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table_merge.py +64 -1
- 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.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table_structure.py +135 -16
- 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.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/utils.py +39 -2
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/patch.py +268 -207
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/__init__.py +4 -4
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/policy.py +1 -1
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/save_pipeline.py +155 -28
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/table_patch.py +20 -9
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/__init__.py +15 -91
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/archive_cli.py +76 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/doc_diff.py +20 -125
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/document_merge.py +601 -77
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/exporter.py +194 -181
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/generic_inventory.py +2 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/ir_equality.py +9 -2
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/package_validator.py +122 -31
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/page_guard.py +11 -1
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/redline.py +15 -5
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/repair.py +70 -1
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/table_navigation.py +14 -274
- {python_hwpx-6.12.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.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/text_extractor.py +27 -7
- python_hwpx-7.0.0/src/hwpx/tools/toc_author.py +921 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/validator.py +51 -11
- {python_hwpx-6.12.0 → python_hwpx-7.0.0/src/python_hwpx.egg-info}/PKG-INFO +81 -59
- python_hwpx-7.0.0/src/python_hwpx.egg-info/SOURCES.txt +208 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/entry_points.txt +0 -1
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/requires.txt +4 -4
- python_hwpx-6.12.0/src/hwpx/_document/_legacy.py +0 -1762
- python_hwpx-6.12.0/src/hwpx/_document/_units.py +0 -16
- python_hwpx-6.12.0/src/hwpx/_document/memos.py +0 -328
- python_hwpx-6.12.0/src/hwpx/_document/ns/_base.py +0 -40
- python_hwpx-6.12.0/src/hwpx/_document/ns/notes.py +0 -210
- python_hwpx-6.12.0/src/hwpx/_document/ns/page.py +0 -615
- python_hwpx-6.12.0/src/hwpx/_document/ns/parts.py +0 -374
- python_hwpx-6.12.0/src/hwpx/_document/ns/refs.py +0 -86
- python_hwpx-6.12.0/src/hwpx/_document/ns/tables.py +0 -132
- python_hwpx-6.12.0/src/hwpx/_document/ns/text.py +0 -391
- python_hwpx-6.12.0/src/hwpx/_document/persistence.py +0 -545
- python_hwpx-6.12.0/src/hwpx/_document/text_blocks.py +0 -385
- python_hwpx-6.12.0/src/hwpx/_document/tracked.py +0 -290
- python_hwpx-6.12.0/src/hwpx/_moved_modules.py +0 -118
- python_hwpx-6.12.0/src/hwpx/equation/__init__.py +0 -54
- python_hwpx-6.12.0/src/hwpx/equation/authoring.py +0 -475
- python_hwpx-6.12.0/src/hwpx/equation/mathml.py +0 -157
- python_hwpx-6.12.0/src/hwpx/equation/render.py +0 -83
- python_hwpx-6.12.0/src/hwpx/errors.py +0 -454
- python_hwpx-6.12.0/src/hwpx/experimental.py +0 -84
- python_hwpx-6.12.0/src/hwpx/ingest/__init__.py +0 -26
- python_hwpx-6.12.0/src/hwpx/ingest/base.py +0 -236
- python_hwpx-6.12.0/src/hwpx/ingest/hwpx_converter.py +0 -290
- python_hwpx-6.12.0/src/hwpx/objects/__init__.py +0 -73
- python_hwpx-6.12.0/src/hwpx/objects/binary_item.py +0 -58
- python_hwpx-6.12.0/src/hwpx/objects/checkbox.py +0 -103
- python_hwpx-6.12.0/src/hwpx/objects/form_field.py +0 -348
- python_hwpx-6.12.0/src/hwpx/objects/highlight.py +0 -41
- python_hwpx-6.12.0/src/hwpx/objects/results.py +0 -373
- python_hwpx-6.12.0/src/hwpx/opc/security.py +0 -240
- python_hwpx-6.12.0/src/hwpx/opc/xml_utils.py +0 -165
- python_hwpx-6.12.0/src/hwpx/oxml/_paragraph_text_edit.py +0 -188
- python_hwpx-6.12.0/src/hwpx/oxml/container.py +0 -377
- python_hwpx-6.12.0/src/hwpx/oxml/dutmal_compose.py +0 -134
- python_hwpx-6.12.0/src/hwpx/oxml/memo.py +0 -567
- python_hwpx-6.12.0/src/hwpx/oxml/note_authoring.py +0 -194
- python_hwpx-6.12.0/src/hwpx/oxml/numbering_kinds.py +0 -178
- python_hwpx-6.12.0/src/hwpx/oxml/run.py +0 -668
- python_hwpx-6.12.0/src/hwpx/oxml/shape_position.py +0 -600
- python_hwpx-6.12.0/src/hwpx/oxml/table_sizes.py +0 -538
- python_hwpx-6.12.0/src/hwpx/tools/document_viewer.py +0 -182
- python_hwpx-6.12.0/src/hwpx/tools/format_rules.py +0 -530
- python_hwpx-6.12.0/src/hwpx/tools/layout_preview.py +0 -752
- python_hwpx-6.12.0/src/hwpx/tools/mail_merge.py +0 -518
- python_hwpx-6.12.0/src/hwpx/tools/markdown_export.py +0 -647
- python_hwpx-6.12.0/src/hwpx/tools/markdown_import.py +0 -473
- python_hwpx-6.12.0/src/hwpx/tools/report_utils.py +0 -132
- python_hwpx-6.12.0/src/hwpx/tools/table_cleanup.py +0 -61
- python_hwpx-6.12.0/src/hwpx/tools/text_extract_cli.py +0 -67
- python_hwpx-6.12.0/src/hwpx/tools/toc_author.py +0 -475
- python_hwpx-6.12.0/src/python_hwpx.egg-info/SOURCES.txt +0 -511
- python_hwpx-6.12.0/tests/test_add_control.py +0 -83
- python_hwpx-6.12.0/tests/test_add_heading.py +0 -355
- python_hwpx-6.12.0/tests/test_adoption_metrics_snapshot.py +0 -90
- python_hwpx-6.12.0/tests/test_append_paragraph_cost.py +0 -61
- python_hwpx-6.12.0/tests/test_arc_authoring.py +0 -294
- python_hwpx-6.12.0/tests/test_authoring_defaults.py +0 -412
- python_hwpx-6.12.0/tests/test_authoring_quality_corpus.py +0 -514
- python_hwpx-6.12.0/tests/test_blind_eval_fixture.py +0 -155
- python_hwpx-6.12.0/tests/test_body_patch.py +0 -190
- python_hwpx-6.12.0/tests/test_body_patch_color_runs.py +0 -197
- python_hwpx-6.12.0/tests/test_body_patch_ops.py +0 -461
- python_hwpx-6.12.0/tests/test_border_fill_image_gradient.py +0 -361
- python_hwpx-6.12.0/tests/test_border_line_types.py +0 -72
- python_hwpx-6.12.0/tests/test_build_element_census.py +0 -186
- python_hwpx-6.12.0/tests/test_byte_patch_identity.py +0 -314
- python_hwpx-6.12.0/tests/test_capabilities_surface.py +0 -198
- python_hwpx-6.12.0/tests/test_cell_border_neighbors.py +0 -135
- python_hwpx-6.12.0/tests/test_cell_edit_holder_cache.py +0 -101
- python_hwpx-6.12.0/tests/test_cell_fields.py +0 -224
- python_hwpx-6.12.0/tests/test_cell_line_spacing.py +0 -177
- python_hwpx-6.12.0/tests/test_cell_margins.py +0 -311
- python_hwpx-6.12.0/tests/test_cell_text_rewrite_semantics.py +0 -145
- python_hwpx-6.12.0/tests/test_char_pr_child_order.py +0 -64
- python_hwpx-6.12.0/tests/test_character_width_ratio.py +0 -35
- python_hwpx-6.12.0/tests/test_chart_authoring.py +0 -313
- python_hwpx-6.12.0/tests/test_check_box_authoring.py +0 -154
- python_hwpx-6.12.0/tests/test_color_arguments.py +0 -170
- python_hwpx-6.12.0/tests/test_column_break.py +0 -109
- python_hwpx-6.12.0/tests/test_column_widths_as_shares.py +0 -119
- python_hwpx-6.12.0/tests/test_comment_node_robustness.py +0 -85
- python_hwpx-6.12.0/tests/test_container_authoring.py +0 -352
- python_hwpx-6.12.0/tests/test_container_members.py +0 -216
- python_hwpx-6.12.0/tests/test_contract_docs_sync.py +0 -41
- python_hwpx-6.12.0/tests/test_corpus_read_fidelity.py +0 -38
- python_hwpx-6.12.0/tests/test_coverage_ledger.py +0 -1104
- python_hwpx-6.12.0/tests/test_coverage_promotion.py +0 -671
- python_hwpx-6.12.0/tests/test_coverage_targets.py +0 -74
- python_hwpx-6.12.0/tests/test_curve_connector_authoring.py +0 -179
- python_hwpx-6.12.0/tests/test_dev_extra_matches_ci.py +0 -41
- python_hwpx-6.12.0/tests/test_deviations_registry.py +0 -454
- python_hwpx-6.12.0/tests/test_distribution_file_sizes.py +0 -89
- python_hwpx-6.12.0/tests/test_doc_diff.py +0 -71
- python_hwpx-6.12.0/tests/test_document_context_manager.py +0 -65
- python_hwpx-6.12.0/tests/test_document_facade_surface.py +0 -87
- python_hwpx-6.12.0/tests/test_document_formatting.py +0 -1995
- python_hwpx-6.12.0/tests/test_document_merge.py +0 -1318
- python_hwpx-6.12.0/tests/test_document_metadata.py +0 -144
- python_hwpx-6.12.0/tests/test_document_ops_runtime_boundary.py +0 -256
- python_hwpx-6.12.0/tests/test_document_save_api.py +0 -319
- python_hwpx-6.12.0/tests/test_document_viewer.py +0 -136
- python_hwpx-6.12.0/tests/test_documentation_code_fences.py +0 -531
- python_hwpx-6.12.0/tests/test_drop_cap_authoring.py +0 -258
- python_hwpx-6.12.0/tests/test_dutmal_compose_authoring.py +0 -238
- python_hwpx-6.12.0/tests/test_edit_clears_line_cache.py +0 -199
- python_hwpx-6.12.0/tests/test_edit_fidelity_corpus.py +0 -311
- python_hwpx-6.12.0/tests/test_edit_plan.py +0 -356
- python_hwpx-6.12.0/tests/test_editor_surface_inventory.py +0 -119
- python_hwpx-6.12.0/tests/test_engine_small_defects_eng36.py +0 -110
- python_hwpx-6.12.0/tests/test_engine_surface_6_0.py +0 -501
- python_hwpx-6.12.0/tests/test_ensure_run_font_by_lang.py +0 -248
- python_hwpx-6.12.0/tests/test_equalize_widths_per_row.py +0 -297
- python_hwpx-6.12.0/tests/test_equation_authoring.py +0 -417
- python_hwpx-6.12.0/tests/test_equation_converter.py +0 -301
- python_hwpx-6.12.0/tests/test_equation_font_boundaries.py +0 -93
- python_hwpx-6.12.0/tests/test_equation_measure_hancom_saved.py +0 -99
- python_hwpx-6.12.0/tests/test_equation_render.py +0 -184
- python_hwpx-6.12.0/tests/test_equation_size.py +0 -109
- python_hwpx-6.12.0/tests/test_equation_width_hancom_boxes.py +0 -73
- python_hwpx-6.12.0/tests/test_error_contract.py +0 -235
- python_hwpx-6.12.0/tests/test_error_messages.py +0 -143
- python_hwpx-6.12.0/tests/test_evalplan_core_primitives.py +0 -71
- python_hwpx-6.12.0/tests/test_existing_document_format_editing.py +0 -203
- python_hwpx-6.12.0/tests/test_export_captions_dutmal.py +0 -162
- python_hwpx-6.12.0/tests/test_export_cell_text_spaces.py +0 -29
- python_hwpx-6.12.0/tests/test_export_list_labels.py +0 -194
- python_hwpx-6.12.0/tests/test_export_notes.py +0 -202
- python_hwpx-6.12.0/tests/test_export_text_boxes.py +0 -157
- python_hwpx-6.12.0/tests/test_exporter_table_text.py +0 -164
- python_hwpx-6.12.0/tests/test_field_marks.py +0 -328
- python_hwpx-6.12.0/tests/test_field_readers.py +0 -158
- python_hwpx-6.12.0/tests/test_field_type_ids.py +0 -120
- python_hwpx-6.12.0/tests/test_fill_image_hancom_modes.py +0 -73
- python_hwpx-6.12.0/tests/test_form_field_authoring.py +0 -221
- python_hwpx-6.12.0/tests/test_form_field_fill_cost.py +0 -66
- python_hwpx-6.12.0/tests/test_form_fields.py +0 -372
- python_hwpx-6.12.0/tests/test_form_fill_core_primitives.py +0 -38
- python_hwpx-6.12.0/tests/test_form_fit.py +0 -587
- python_hwpx-6.12.0/tests/test_form_fit_hancom_rules.py +0 -2100
- python_hwpx-6.12.0/tests/test_form_fit_integration.py +0 -200
- python_hwpx-6.12.0/tests/test_format_rules.py +0 -233
- python_hwpx-6.12.0/tests/test_fuzz_catalog_derive_expected.py +0 -173
- python_hwpx-6.12.0/tests/test_fuzz_loop.py +0 -129
- python_hwpx-6.12.0/tests/test_fuzz_regressions.py +0 -56
- python_hwpx-6.12.0/tests/test_gap_and_new_number_values.py +0 -143
- python_hwpx-6.12.0/tests/test_gap_closure_tools.py +0 -788
- python_hwpx-6.12.0/tests/test_glyph_table_data.py +0 -58
- python_hwpx-6.12.0/tests/test_golden_api.py +0 -305
- python_hwpx-6.12.0/tests/test_header_compat_authoring.py +0 -319
- python_hwpx-6.12.0/tests/test_header_control_before_field.py +0 -78
- python_hwpx-6.12.0/tests/test_header_list_lookups.py +0 -71
- python_hwpx-6.12.0/tests/test_header_lookup_cache.py +0 -91
- python_hwpx-6.12.0/tests/test_heading_style_shapes.py +0 -58
- python_hwpx-6.12.0/tests/test_highlight_authoring.py +0 -289
- python_hwpx-6.12.0/tests/test_hp_tab_support.py +0 -64
- python_hwpx-6.12.0/tests/test_hwp5_container.py +0 -255
- python_hwpx-6.12.0/tests/test_hwp5_hancom_files.py +0 -163
- python_hwpx-6.12.0/tests/test_hwp5_open.py +0 -1387
- python_hwpx-6.12.0/tests/test_hwp5_open_errors.py +0 -110
- python_hwpx-6.12.0/tests/test_hwp5_save.py +0 -1989
- python_hwpx-6.12.0/tests/test_hwp5_scripts_limits.py +0 -60
- python_hwpx-6.12.0/tests/test_hwpxlib_corpus_read.py +0 -36
- python_hwpx-6.12.0/tests/test_hyperlink_hancom_form.py +0 -110
- python_hwpx-6.12.0/tests/test_id_generator_range.py +0 -32
- python_hwpx-6.12.0/tests/test_id_integrity.py +0 -54
- python_hwpx-6.12.0/tests/test_image_object_workflow.py +0 -294
- python_hwpx-6.12.0/tests/test_index_mark.py +0 -158
- python_hwpx-6.12.0/tests/test_ingest.py +0 -124
- python_hwpx-6.12.0/tests/test_inline_models.py +0 -113
- python_hwpx-6.12.0/tests/test_insert_column_by_clone.py +0 -200
- python_hwpx-6.12.0/tests/test_insert_row_merged_cells.py +0 -130
- python_hwpx-6.12.0/tests/test_insert_row_sides.py +0 -193
- python_hwpx-6.12.0/tests/test_instid_attribute_case.py +0 -126
- python_hwpx-6.12.0/tests/test_integration_hwpx_compatibility.py +0 -228
- python_hwpx-6.12.0/tests/test_integration_roundtrip.py +0 -327
- python_hwpx-6.12.0/tests/test_internal_calls_skip_moved_names.py +0 -77
- python_hwpx-6.12.0/tests/test_known_leak_migration_contract.py +0 -94
- python_hwpx-6.12.0/tests/test_layer_leak_guard.py +0 -181
- python_hwpx-6.12.0/tests/test_layout_cache_scope.py +0 -293
- python_hwpx-6.12.0/tests/test_layout_line_cache.py +0 -991
- python_hwpx-6.12.0/tests/test_layout_lint.py +0 -816
- python_hwpx-6.12.0/tests/test_layout_page_estimate.py +0 -2995
- python_hwpx-6.12.0/tests/test_layout_pages_split.py +0 -64
- python_hwpx-6.12.0/tests/test_layout_preview.py +0 -60
- python_hwpx-6.12.0/tests/test_lazy_hwp5_import.py +0 -87
- python_hwpx-6.12.0/tests/test_lazy_tools_import.py +0 -91
- python_hwpx-6.12.0/tests/test_lazy_tools_submodules.py +0 -149
- python_hwpx-6.12.0/tests/test_library_boundary_closure.py +0 -195
- python_hwpx-6.12.0/tests/test_line_break_writing.py +0 -214
- python_hwpx-6.12.0/tests/test_line_width_arguments.py +0 -94
- python_hwpx-6.12.0/tests/test_list_continue.py +0 -112
- python_hwpx-6.12.0/tests/test_list_defaults_vs_hancom.py +0 -80
- python_hwpx-6.12.0/tests/test_list_level_range.py +0 -53
- python_hwpx-6.12.0/tests/test_llms_txt.py +0 -124
- python_hwpx-6.12.0/tests/test_mail_merge_xlsx.py +0 -38
- python_hwpx-6.12.0/tests/test_manifest_resolve_once.py +0 -52
- python_hwpx-6.12.0/tests/test_markdown_export.py +0 -436
- python_hwpx-6.12.0/tests/test_markdown_export_shape_text.py +0 -75
- python_hwpx-6.12.0/tests/test_markdown_import.py +0 -208
- python_hwpx-6.12.0/tests/test_master_page_authoring.py +0 -181
- python_hwpx-6.12.0/tests/test_master_page_pages_taken.py +0 -181
- python_hwpx-6.12.0/tests/test_memo_and_style_editing.py +0 -474
- python_hwpx-6.12.0/tests/test_memo_fields.py +0 -124
- python_hwpx-6.12.0/tests/test_memo_shape_authoring.py +0 -249
- python_hwpx-6.12.0/tests/test_merge_cells_hancom_files.py +0 -46
- python_hwpx-6.12.0/tests/test_merge_cells_keeps_contents.py +0 -180
- python_hwpx-6.12.0/tests/test_migration_seams.py +0 -116
- python_hwpx-6.12.0/tests/test_moved_module_imports.py +0 -105
- python_hwpx-6.12.0/tests/test_moved_surface_hints.py +0 -66
- python_hwpx-6.12.0/tests/test_mutation_report.py +0 -343
- python_hwpx-6.12.0/tests/test_namespace_handling.py +0 -134
- python_hwpx-6.12.0/tests/test_namespace_hygiene.py +0 -192
- python_hwpx-6.12.0/tests/test_namespace_normalization.py +0 -109
- python_hwpx-6.12.0/tests/test_native_edit_contract.py +0 -338
- python_hwpx-6.12.0/tests/test_nested_cell_fill_safety.py +0 -301
- python_hwpx-6.12.0/tests/test_nested_table_structure_edits.py +0 -259
- python_hwpx-6.12.0/tests/test_new_features.py +0 -593
- python_hwpx-6.12.0/tests/test_note_authoring_contract.py +0 -121
- python_hwpx-6.12.0/tests/test_ns_fields.py +0 -157
- python_hwpx-6.12.0/tests/test_ns_media.py +0 -94
- python_hwpx-6.12.0/tests/test_ns_notes.py +0 -120
- python_hwpx-6.12.0/tests/test_ns_page.py +0 -284
- python_hwpx-6.12.0/tests/test_ns_refs.py +0 -77
- python_hwpx-6.12.0/tests/test_ns_shapes.py +0 -198
- python_hwpx-6.12.0/tests/test_ns_tables.py +0 -130
- python_hwpx-6.12.0/tests/test_ns_tracking.py +0 -139
- python_hwpx-6.12.0/tests/test_number_formats.py +0 -132
- python_hwpx-6.12.0/tests/test_opc_package.py +0 -969
- python_hwpx-6.12.0/tests/test_open_damaged_input.py +0 -158
- python_hwpx-6.12.0/tests/test_open_safety_corpus.py +0 -88
- python_hwpx-6.12.0/tests/test_outline_numbering.py +0 -120
- python_hwpx-6.12.0/tests/test_oxml_modularization.py +0 -453
- python_hwpx-6.12.0/tests/test_oxml_parsing.py +0 -385
- python_hwpx-6.12.0/tests/test_package_hygiene.py +0 -558
- python_hwpx-6.12.0/tests/test_package_text_and_namespaces.py +0 -291
- python_hwpx-6.12.0/tests/test_packaging_license_metadata.py +0 -63
- python_hwpx-6.12.0/tests/test_packaging_py_typed.py +0 -42
- python_hwpx-6.12.0/tests/test_page_and_list_values.py +0 -161
- python_hwpx-6.12.0/tests/test_page_number_control.py +0 -323
- python_hwpx-6.12.0/tests/test_page_number_format.py +0 -73
- python_hwpx-6.12.0/tests/test_page_orientation.py +0 -157
- python_hwpx-6.12.0/tests/test_para_pr_dedup.py +0 -133
- python_hwpx-6.12.0/tests/test_paragraph_align_distribute_space.py +0 -41
- python_hwpx-6.12.0/tests/test_paragraph_border.py +0 -168
- python_hwpx-6.12.0/tests/test_paragraph_format_targets.py +0 -218
- python_hwpx-6.12.0/tests/test_paragraph_hyperlink_style.py +0 -127
- python_hwpx-6.12.0/tests/test_paragraph_keep_together.py +0 -46
- python_hwpx-6.12.0/tests/test_paragraph_margin_default_scale.py +0 -89
- python_hwpx-6.12.0/tests/test_paragraph_matcher.py +0 -126
- python_hwpx-6.12.0/tests/test_paragraph_property_lookup.py +0 -82
- python_hwpx-6.12.0/tests/test_paragraph_property_version_switch.py +0 -160
- python_hwpx-6.12.0/tests/test_paragraph_remove_in_containers.py +0 -133
- python_hwpx-6.12.0/tests/test_paragraph_section_management.py +0 -459
- python_hwpx-6.12.0/tests/test_part_hierarchy_read_models.py +0 -250
- python_hwpx-6.12.0/tests/test_picture_adjustments.py +0 -256
- python_hwpx-6.12.0/tests/test_polygon_authoring.py +0 -368
- python_hwpx-6.12.0/tests/test_preview_and_markdown_untrusted_values.py +0 -171
- python_hwpx-6.12.0/tests/test_product_boundary.py +0 -923
- python_hwpx-6.12.0/tests/test_public_artifact_hygiene.py +0 -570
- python_hwpx-6.12.0/tests/test_public_exceptions_inherit_hwpx_error.py +0 -48
- python_hwpx-6.12.0/tests/test_public_runtime_boundary.py +0 -12
- python_hwpx-6.12.0/tests/test_read_fidelity.py +0 -170
- python_hwpx-6.12.0/tests/test_recover_broken_zip.py +0 -332
- python_hwpx-6.12.0/tests/test_redline_authoring.py +0 -349
- python_hwpx-6.12.0/tests/test_redline_verify.py +0 -130
- python_hwpx-6.12.0/tests/test_release_checklist_example.py +0 -37
- python_hwpx-6.12.0/tests/test_release_workflow_safety.py +0 -1182
- python_hwpx-6.12.0/tests/test_remove_unused_charts.py +0 -104
- python_hwpx-6.12.0/tests/test_remove_unused_images.py +0 -84
- python_hwpx-6.12.0/tests/test_repair_repack.py +0 -347
- python_hwpx-6.12.0/tests/test_replace_text_barriers.py +0 -113
- python_hwpx-6.12.0/tests/test_report_utils.py +0 -56
- python_hwpx-6.12.0/tests/test_repr_snapshots.py +0 -68
- python_hwpx-6.12.0/tests/test_return_contract.py +0 -523
- python_hwpx-6.12.0/tests/test_roundtrip_fidelity.py +0 -92
- python_hwpx-6.12.0/tests/test_roundtrip_fidelity_corpus.py +0 -47
- python_hwpx-6.12.0/tests/test_row_heights.py +0 -76
- python_hwpx-6.12.0/tests/test_run_choice_atom_authoring.py +0 -174
- python_hwpx-6.12.0/tests/test_run_content_kinds.py +0 -117
- python_hwpx-6.12.0/tests/test_run_font_refs.py +0 -53
- python_hwpx-6.12.0/tests/test_run_style_base.py +0 -100
- python_hwpx-6.12.0/tests/test_safe_edit_example.py +0 -129
- python_hwpx-6.12.0/tests/test_save_keeps_inline_text_caches.py +0 -78
- python_hwpx-6.12.0/tests/test_save_pipeline.py +0 -322
- python_hwpx-6.12.0/tests/test_save_verifies_once.py +0 -62
- python_hwpx-6.12.0/tests/test_save_with_comment_nodes.py +0 -122
- python_hwpx-6.12.0/tests/test_section_clear_body.py +0 -611
- python_hwpx-6.12.0/tests/test_section_columns.py +0 -247
- python_hwpx-6.12.0/tests/test_section_headers.py +0 -383
- python_hwpx-6.12.0/tests/test_section_ids_order.py +0 -136
- python_hwpx-6.12.0/tests/test_section_properties_real_roundtrip.py +0 -101
- python_hwpx-6.12.0/tests/test_set_column_widths_uniform_split.py +0 -65
- python_hwpx-6.12.0/tests/test_set_paragraph_format_keep.py +0 -73
- python_hwpx-6.12.0/tests/test_shape_geometry_contract.py +0 -353
- python_hwpx-6.12.0/tests/test_shape_open_safety_risk_check.py +0 -213
- python_hwpx-6.12.0/tests/test_shape_original_size.py +0 -167
- python_hwpx-6.12.0/tests/test_shape_position_frames.py +0 -355
- python_hwpx-6.12.0/tests/test_shape_size_values.py +0 -212
- python_hwpx-6.12.0/tests/test_size_ratchet.py +0 -102
- python_hwpx-6.12.0/tests/test_skeleton_template_ids.py +0 -25
- python_hwpx-6.12.0/tests/test_split_cell.py +0 -229
- python_hwpx-6.12.0/tests/test_split_merged_cell.py +0 -188
- python_hwpx-6.12.0/tests/test_stable_surface.py +0 -357
- python_hwpx-6.12.0/tests/test_stale_layout_cache_sweep.py +0 -197
- python_hwpx-6.12.0/tests/test_story_edits_reach_control_copy.py +0 -256
- python_hwpx-6.12.0/tests/test_style_font_border_reads.py +0 -830
- python_hwpx-6.12.0/tests/test_style_resolution.py +0 -348
- python_hwpx-6.12.0/tests/test_styles_definition_verbs.py +0 -98
- python_hwpx-6.12.0/tests/test_tab_character_writing.py +0 -107
- python_hwpx-6.12.0/tests/test_tab_definition_version_switch.py +0 -230
- python_hwpx-6.12.0/tests/test_table_cell_equalize.py +0 -93
- python_hwpx-6.12.0/tests/test_table_cleanup.py +0 -49
- python_hwpx-6.12.0/tests/test_table_clone_identities.py +0 -210
- python_hwpx-6.12.0/tests/test_table_column_floor.py +0 -119
- python_hwpx-6.12.0/tests/test_table_grid_cache.py +0 -127
- python_hwpx-6.12.0/tests/test_table_label.py +0 -150
- python_hwpx-6.12.0/tests/test_table_navigation.py +0 -242
- python_hwpx-6.12.0/tests/test_table_ops_cells_without_geometry.py +0 -61
- python_hwpx-6.12.0/tests/test_table_ops_delete_every_line.py +0 -44
- python_hwpx-6.12.0/tests/test_table_ops_delete_zones.py +0 -74
- python_hwpx-6.12.0/tests/test_table_page_flow.py +0 -57
- python_hwpx-6.12.0/tests/test_table_patch.py +0 -602
- python_hwpx-6.12.0/tests/test_table_patch_dryrun.py +0 -64
- python_hwpx-6.12.0/tests/test_table_patch_m105.py +0 -271
- python_hwpx-6.12.0/tests/test_table_patch_structure_fixes.py +0 -224
- python_hwpx-6.12.0/tests/test_table_split_merge.py +0 -258
- python_hwpx-6.12.0/tests/test_table_structure_edits.py +0 -416
- python_hwpx-6.12.0/tests/test_tables_default_border.py +0 -81
- python_hwpx-6.12.0/tests/test_template_analyzer_enrichment.py +0 -97
- python_hwpx-6.12.0/tests/test_text_blocks.py +0 -223
- python_hwpx-6.12.0/tests/test_text_box_fields.py +0 -87
- python_hwpx-6.12.0/tests/test_text_extractor_annotations.py +0 -126
- python_hwpx-6.12.0/tests/test_text_extractor_nested_once.py +0 -107
- python_hwpx-6.12.0/tests/test_text_extractor_run_choice_atoms.py +0 -160
- python_hwpx-6.12.0/tests/test_text_inline_elements.py +0 -180
- python_hwpx-6.12.0/tests/test_text_replace_everywhere.py +0 -211
- python_hwpx-6.12.0/tests/test_title_mark.py +0 -133
- python_hwpx-6.12.0/tests/test_toc_author.py +0 -304
- python_hwpx-6.12.0/tests/test_toc_fidelity.py +0 -250
- python_hwpx-6.12.0/tests/test_tools_untrusted_xml.py +0 -74
- python_hwpx-6.12.0/tests/test_tracked_overlap_render_smoke.py +0 -112
- python_hwpx-6.12.0/tests/test_tracked_paragraph_delete_break.py +0 -47
- python_hwpx-6.12.0/tests/test_trailing_table_text.py +0 -153
- python_hwpx-6.12.0/tests/test_validation_severity.py +0 -52
- python_hwpx-6.12.0/tests/test_validator_comment_nodes.py +0 -56
- python_hwpx-6.12.0/tests/test_validator_form_parameters.py +0 -96
- python_hwpx-6.12.0/tests/test_validator_full_schema.py +0 -152
- python_hwpx-6.12.0/tests/test_validator_hancom_open_rules.py +0 -313
- python_hwpx-6.12.0/tests/test_validator_section_ids.py +0 -141
- python_hwpx-6.12.0/tests/test_version_metadata.py +0 -34
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/LICENSE +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/NOTICE +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/setup.cfg +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/__init__.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/__init__.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_trailing_table_text.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/body_patch.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/Skeleton.hwpx +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/_glyph_table.json.gz +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/_glyph_table.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/apply.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/engine.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/policy.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/report.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/__init__.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/binary.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/bodytext.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/controls.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/errors.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/fileheader.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_common.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/shapes.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/summary.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/writer.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/__init__.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/line_cache.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/pages.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/report.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/objects/tracked.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/opc/relationships.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/body.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/canonical_defaults.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/color.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/common.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_compat.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/history_part.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/master_page.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/parser.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/schema.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/settings.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/version_part.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/package.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/__init__.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_execute.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_model.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_schema.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_validate.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/py.typed +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/ledger.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/rendering.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/report.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/templates.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/header.xsd +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-body.xsd +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-core.xsd +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-header.xsd +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-paralist.xsd +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-xml.xsd +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/section.xsd +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/id_integrity.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/idempotence.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/object_finder.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/package_reconcile.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/read_fidelity.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/recover.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/roundtrip_diff.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/toc_fidelity.py +0 -0
- {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/dependency_links.txt +0 -0
- {python_hwpx-6.12.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,14 +28,13 @@ 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"
|
|
35
37
|
Requires-Dist: numpy>=1.26; extra == "dev"
|
|
36
|
-
Requires-Dist: openpyxl>=3.1; extra == "dev"
|
|
37
38
|
Requires-Dist: pillow>=10.0; extra == "dev"
|
|
38
39
|
Requires-Dist: pytest>=7.4; extra == "dev"
|
|
39
40
|
Requires-Dist: pytest-cov>=5.0; extra == "dev"
|
|
@@ -45,7 +46,6 @@ Requires-Dist: pyright>=1.1.390; extra == "dev"
|
|
|
45
46
|
Provides-Extra: test
|
|
46
47
|
Requires-Dist: build>=1.0; extra == "test"
|
|
47
48
|
Requires-Dist: numpy>=1.26; extra == "test"
|
|
48
|
-
Requires-Dist: openpyxl>=3.1; extra == "test"
|
|
49
49
|
Requires-Dist: pillow>=10.0; extra == "test"
|
|
50
50
|
Requires-Dist: pytest>=7.4; extra == "test"
|
|
51
51
|
Requires-Dist: pytest-cov>=5.0; extra == "test"
|
|
@@ -72,11 +72,11 @@ Dynamic: license-file
|
|
|
72
72
|
</p>
|
|
73
73
|
</p>
|
|
74
74
|
|
|
75
|
-
<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>
|
|
76
76
|
|
|
77
77
|
HWPX는 ZIP 안에 XML(OWPML)을 담은 형식이라, 한컴오피스가 없어도 파이썬만으로 다룰 수 있습니다.
|
|
78
78
|
python-hwpx는 Windows·macOS·Linux·CI 어디서나 돌고 의존성은 `lxml` 하나입니다. HWP 5.0(`.hwp`)도 같은
|
|
79
|
-
API로
|
|
79
|
+
API로 열어 HWPX로 바꿉니다.
|
|
80
80
|
|
|
81
81
|
만든 문서는 한컴오피스 2024에서 직접 열어 보고 그 결과를 날짜와 함께
|
|
82
82
|
[아래](#한글과-얼마나-같은가)에 적어 둡니다.
|
|
@@ -95,73 +95,95 @@ from hwpx import HwpxDocument
|
|
|
95
95
|
doc = HwpxDocument.new()
|
|
96
96
|
doc.add_heading("2026 운영계획", level=1)
|
|
97
97
|
doc.add_paragraph("추진 배경", style="개요 2") # 한/글이 "가." 번호를 붙인다
|
|
98
|
-
doc.
|
|
98
|
+
doc.save("계획.hwpx")
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
스타일은 이름으로 고릅니다. 없는 이름을 쓰면 그 줄에서 바로 오류가 납니다.
|
|
102
102
|
있는 문서를 고칠 때는 `HwpxDocument.open("보고서.hwpx")`로 시작합니다. `.hwp`도 똑같이 열고,
|
|
103
|
-
`
|
|
103
|
+
고친 결과는 `save("보고서.hwpx")`로 HWPX로 저장합니다.
|
|
104
104
|
|
|
105
|
-
|
|
106
|
-
|
|
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
|
+
오류가 새 이름을 알려 줍니다.
|
|
107
131
|
|
|
108
132
|
> 예전 설치 명령을 위해 `pip install "python-hwpx[visual]"`도 계속 됩니다. 다만 이 extra는 비어 있어
|
|
109
133
|
> 렌더·PDF 의존성을 설치하지 않습니다. 그 일은 `python-hwpx-automation[oracle]`이 맡습니다.
|
|
110
134
|
|
|
111
135
|
## 할 수 있는 것
|
|
112
136
|
|
|
113
|
-
- 읽기·추출:
|
|
114
|
-
`
|
|
115
|
-
|
|
116
|
-
|
|
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-파이프라인에서-읽기)).
|
|
117
141
|
- 편집: 문단·표·그림·머리말/꼬리말·메모·각주, 줄 간격·여백·쪽 번호 같은 서식을 고칩니다.
|
|
118
|
-
- 양식 채우기:
|
|
142
|
+
- 양식 채우기: 칸·누름틀에 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
|
|
119
143
|
칸에 들어가도록 줄을 바꾸거나 글자를 줄일지 한/글의 글자 폭으로 재서 고릅니다.
|
|
120
144
|
- 표 구조 편집: 행·열 넣기와 지우기, 칸 나누기와 합치기. `doc.tables[0]`처럼 번호로 표를 꺼냅니다.
|
|
121
|
-
- 만들기·일괄 처리: 새 문서, 목차·상호 참조,
|
|
122
|
-
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고
|
|
123
|
-
`document.conversion_report`에 남습니다.
|
|
145
|
+
- 만들기·일괄 처리: 새 문서, 목차·상호 참조, 문서 비교, 변경 추적.
|
|
146
|
+
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고 HWPX로 저장합니다. 옮기지 못한 내용은
|
|
147
|
+
`document.conversion_report`에 남습니다. `.hwp`로 다시 쓰는 기능은 실험입니다. 연 원본을 덮어쓰지 않고,
|
|
148
|
+
옮기지 못한 내용이 있으면 쓰지 않습니다.
|
|
124
149
|
- 배치 추정(실험): `estimate_pages`는 한/글 없이 쪽 수와 줄마다의 쪽·세로 위치를 추정합니다.
|
|
125
150
|
`write_line_caches`는 한/글이 저장할 때 쓰는 줄 배치 정보를, 한/글과 같은 값을 확실히 아는 문단에만 씁니다.
|
|
126
151
|
rhwp처럼 이 정보로 그림 자리를 찾는 뷰어에서도 그림이 보이게 됩니다. 기본으로는 쓰지 않습니다.
|
|
127
|
-
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`
|
|
128
|
-
문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `
|
|
129
|
-
([검사 범위](docs/usage.md#변경-사항-저장과-결과물-확인)).
|
|
152
|
+
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`save()`가 돌려주는 `MutationReport`). 기본 저장은 없는 글자 모양·
|
|
153
|
+
문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `save(..., quality=QualityPolicy(require_visual_complete=False))`가 합니다
|
|
154
|
+
([검사 범위](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md#변경-사항-저장과-결과물-확인)).
|
|
130
155
|
|
|
131
|
-
자세한 내용: [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)
|
|
132
157
|
|
|
133
158
|
### 양식 채우기 예
|
|
134
159
|
|
|
135
160
|
```python
|
|
136
161
|
doc = HwpxDocument.open("신청서.hwpx")
|
|
137
|
-
|
|
138
|
-
"
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
if result["failed_count"] or result["applied_count"] != len(values):
|
|
143
|
-
raise ValueError(result["failed"])
|
|
144
|
-
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")
|
|
145
167
|
```
|
|
146
168
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
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
|
+
합친 칸은 덮는 자리마다 같은 글로 한 번씩 나옵니다.
|
|
150
178
|
|
|
151
179
|
*독립 실행 예제로 표시하지 않은 블록은 여러분이 가진 문서를 입력으로 쓰는 조각입니다. 예제별 Python 블록 판정은
|
|
152
|
-
[실행 기록](docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
180
|
+
[실행 기록](https://github.com/airmang/python-hwpx/blob/main/docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
153
181
|
|
|
154
182
|
## 한/글과 얼마나 같은가
|
|
155
183
|
|
|
156
184
|
만든 파일을 실제 한컴오피스로 열어 보고 그대로 적습니다. 숫자마다 잰 날짜와 프로그램 판을 붙입니다.
|
|
157
185
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
| 무엇을 | 정답 | 결과 |
|
|
161
|
-
|---|---|---|
|
|
162
|
-
| 공개 실문서 77건의 줄 나눔이 같은 문단 | 한컴오피스 2024 (Windows)가 배치해 저장한 것 | 8,246 / 8,263 (99.8 %) |
|
|
163
|
-
| 그 77건 중 모든 줄의 쪽·위치가 같은 문서 | 같음 | 76 / 77 (나머지 1건은 표가 깨진 문서) |
|
|
164
|
-
| 줄 배치 정보를 지운 사본으로 추정한 쪽 수가 같은 문서 (공개 79 · 비공개 실문서 522 · 기능 시험 문서 780) | 그 문서를 저장한 한/글의 쪽 수 | 1,344 / 1,381 (추정하지 않음 16) |
|
|
186
|
+
줄 배치와 쪽 수 추정은 실험 기능입니다. 정확도 숫자는 측정 스크립트와 기록을 저장소에 함께 실을 수 있을 때 적습니다.
|
|
165
187
|
|
|
166
188
|
**열림: 한컴오피스 12 (macOS)**
|
|
167
189
|
|
|
@@ -177,10 +199,10 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
177
199
|
<p align="center"><sub>ChatGPT 실행 환경에서 만든 문서를 실제 한컴오피스로 연 모습.</sub></p>
|
|
178
200
|
|
|
179
201
|
전체 숫자와 주의할 점은 [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)에,
|
|
180
|
-
기능별 등급은 [지원 매트릭스](docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
202
|
+
기능별 등급은 [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
181
203
|
받는가"를 잰 것이고 파서가 문서를 얼마나 잘 읽는지와는 다른 지표입니다.
|
|
182
204
|
|
|
183
|
-
개발 단계는
|
|
205
|
+
개발 단계는 안정(Production/Stable)입니다. 하위 호환을 지키는 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)에 적혀 있고,
|
|
184
206
|
`hwpx.experimental`과 위에서 "실험"이라고 적은 기능은 바뀔 수 있습니다.
|
|
185
207
|
|
|
186
208
|
## 어디서 쓰나
|
|
@@ -188,8 +210,8 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
188
210
|
| 환경 | 방법 |
|
|
189
211
|
|---|---|
|
|
190
212
|
| 로컬·서버 파이썬 | `pip install python-hwpx` (스크립트·배치·CI) |
|
|
191
|
-
| 파이썬 자동화 (MCP 없이) | `pip install python-hwpx-automation` (저작·양식 채움·검증 워크플로) |
|
|
192
|
-
| 일반 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)) |
|
|
193
215
|
| ChatGPT MCP 앱 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)의 MCP adapter를 커넥터로 등록 |
|
|
194
216
|
| Codex 마켓플레이스 플러그인 | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) 설치 |
|
|
195
217
|
| Claude Code · Hermes · OpenClaw | 같은 MCP 서버를 각 클라이언트에 등록 ([`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)) |
|
|
@@ -209,7 +231,7 @@ ChatGPT 채팅의 파이썬 환경은 PyPI에 접속하지 못합니다. 그래
|
|
|
209
231
|
```
|
|
210
232
|
|
|
211
233
|
설치부터 결과 파일까지 대화 안에서 끝나므로 내 컴퓨터에 파이썬이 없어도 됩니다. wheel의 의존성은 `lxml`
|
|
212
|
-
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](docs/ai-assistants.md)에,
|
|
234
|
+
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)에,
|
|
213
235
|
AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.github.io/python-hwpx/llms.txt)도 있습니다.
|
|
214
236
|
|
|
215
237
|
| | 저장소 | 역할 |
|
|
@@ -222,19 +244,19 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
222
244
|
|
|
223
245
|
| | python-hwpx | pyhwpx | pyhwp |
|
|
224
246
|
|---|---|---|---|
|
|
225
|
-
| **다루는 형식** | `.hwpx
|
|
247
|
+
| **다루는 형식** | `.hwpx` 읽기·쓰기, `.hwp` (HWP 5.0) 읽기 | `.hwpx` | `.hwp` (v5 바이너리) |
|
|
226
248
|
| **한/글 설치** | 필요 없음 | 필요 (Windows COM) | 필요 없음 |
|
|
227
249
|
| **운영체제** | Linux / macOS / Windows / CI | Windows 전용 | Linux / macOS / Windows |
|
|
228
250
|
| **편집·생성** | ✅ | ✅ (한/글이 함) | 대부분 읽기 |
|
|
229
251
|
| **한/글 없이 쪽 수 추정** | ✅ (실험) | 한/글이 계산 | ❌ |
|
|
230
|
-
| **AI 에이전트 연동 (MCP)** | ✅ (automation 경유) | ❌ | ❌ |
|
|
231
252
|
|
|
232
253
|
## 알려진 제약
|
|
233
254
|
|
|
234
|
-
- `add_shape()
|
|
235
|
-
경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는
|
|
236
|
-
`
|
|
237
|
-
`
|
|
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()`를 쓰세요.
|
|
238
260
|
- 그림은 밝기·대비·회색조·흑백·투명도, 실선 테두리, 자르기(`crop`), 그림자·빛남·부드러운 가장자리·반사
|
|
239
261
|
(`shadow`·`glow`·`soft_edge`·`reflection`)를 `add_picture()` 인자로 줄 수 있습니다. 뒤집기와 회전은 아직 안 됩니다.
|
|
240
262
|
- 쪽 수 추정과 줄 배치 정보 쓰기는 실험 기능입니다. 따르지 못하는 요소가 있으면 추정하지 않고 까닭을 돌려줍니다.
|
|
@@ -248,11 +270,11 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
248
270
|
[help wanted](https://github.com/airmang/python-hwpx/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) ·
|
|
249
271
|
[로드맵](https://github.com/airmang/python-hwpx/milestones) ·
|
|
250
272
|
[Discussions](https://github.com/airmang/python-hwpx/discussions) ·
|
|
251
|
-
[CONTRIBUTING](CONTRIBUTING.md)
|
|
273
|
+
[CONTRIBUTING](https://github.com/airmang/python-hwpx/blob/main/CONTRIBUTING.md)
|
|
252
274
|
|
|
253
|
-
HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals
|
|
254
|
-
캐시, 목차 필드, OPC 재압축 같은 내용을 정리해 두었습니다. 공개 API의 안정 범위는 [안정 API 표면](docs/stable-api.md),
|
|
255
|
-
계층 사이의 소유권은 [제품 경계 문서](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)에 있습니다.
|
|
256
278
|
|
|
257
279
|
## 감사의 말
|
|
258
280
|
|
|
@@ -266,4 +288,4 @@ HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals/)
|
|
|
266
288
|
|
|
267
289
|
## License · Maintainer
|
|
268
290
|
|
|
269
|
-
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,73 +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
|
-
- 읽기·추출:
|
|
55
|
-
`
|
|
56
|
-
|
|
57
|
-
|
|
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-파이프라인에서-읽기)).
|
|
58
82
|
- 편집: 문단·표·그림·머리말/꼬리말·메모·각주, 줄 간격·여백·쪽 번호 같은 서식을 고칩니다.
|
|
59
|
-
- 양식 채우기:
|
|
83
|
+
- 양식 채우기: 칸·누름틀에 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
|
|
60
84
|
칸에 들어가도록 줄을 바꾸거나 글자를 줄일지 한/글의 글자 폭으로 재서 고릅니다.
|
|
61
85
|
- 표 구조 편집: 행·열 넣기와 지우기, 칸 나누기와 합치기. `doc.tables[0]`처럼 번호로 표를 꺼냅니다.
|
|
62
|
-
- 만들기·일괄 처리: 새 문서, 목차·상호 참조,
|
|
63
|
-
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고
|
|
64
|
-
`document.conversion_report`에 남습니다.
|
|
86
|
+
- 만들기·일괄 처리: 새 문서, 목차·상호 참조, 문서 비교, 변경 추적.
|
|
87
|
+
- HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고 HWPX로 저장합니다. 옮기지 못한 내용은
|
|
88
|
+
`document.conversion_report`에 남습니다. `.hwp`로 다시 쓰는 기능은 실험입니다. 연 원본을 덮어쓰지 않고,
|
|
89
|
+
옮기지 못한 내용이 있으면 쓰지 않습니다.
|
|
65
90
|
- 배치 추정(실험): `estimate_pages`는 한/글 없이 쪽 수와 줄마다의 쪽·세로 위치를 추정합니다.
|
|
66
91
|
`write_line_caches`는 한/글이 저장할 때 쓰는 줄 배치 정보를, 한/글과 같은 값을 확실히 아는 문단에만 씁니다.
|
|
67
92
|
rhwp처럼 이 정보로 그림 자리를 찾는 뷰어에서도 그림이 보이게 됩니다. 기본으로는 쓰지 않습니다.
|
|
68
|
-
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`
|
|
69
|
-
문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `
|
|
70
|
-
([검사 범위](docs/usage.md#변경-사항-저장과-결과물-확인)).
|
|
93
|
+
- 검증·안전: 패키지 구조 검사 CLI, 저장 전 열림 검사, 저장 결과 보고(`save()`가 돌려주는 `MutationReport`). 기본 저장은 없는 글자 모양·
|
|
94
|
+
문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `save(..., quality=QualityPolicy(require_visual_complete=False))`가 합니다
|
|
95
|
+
([검사 범위](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md#변경-사항-저장과-결과물-확인)).
|
|
71
96
|
|
|
72
|
-
자세한 내용: [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)
|
|
73
98
|
|
|
74
99
|
### 양식 채우기 예
|
|
75
100
|
|
|
76
101
|
```python
|
|
77
102
|
doc = HwpxDocument.open("신청서.hwpx")
|
|
78
|
-
|
|
79
|
-
"
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
if result["failed_count"] or result["applied_count"] != len(values):
|
|
84
|
-
raise ValueError(result["failed"])
|
|
85
|
-
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")
|
|
86
108
|
```
|
|
87
109
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
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
|
+
합친 칸은 덮는 자리마다 같은 글로 한 번씩 나옵니다.
|
|
91
119
|
|
|
92
120
|
*독립 실행 예제로 표시하지 않은 블록은 여러분이 가진 문서를 입력으로 쓰는 조각입니다. 예제별 Python 블록 판정은
|
|
93
|
-
[실행 기록](docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
121
|
+
[실행 기록](https://github.com/airmang/python-hwpx/blob/main/docs/python-example-ledger.json)에 남겨 둡니다.*
|
|
94
122
|
|
|
95
123
|
## 한/글과 얼마나 같은가
|
|
96
124
|
|
|
97
125
|
만든 파일을 실제 한컴오피스로 열어 보고 그대로 적습니다. 숫자마다 잰 날짜와 프로그램 판을 붙입니다.
|
|
98
126
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
| 무엇을 | 정답 | 결과 |
|
|
102
|
-
|---|---|---|
|
|
103
|
-
| 공개 실문서 77건의 줄 나눔이 같은 문단 | 한컴오피스 2024 (Windows)가 배치해 저장한 것 | 8,246 / 8,263 (99.8 %) |
|
|
104
|
-
| 그 77건 중 모든 줄의 쪽·위치가 같은 문서 | 같음 | 76 / 77 (나머지 1건은 표가 깨진 문서) |
|
|
105
|
-
| 줄 배치 정보를 지운 사본으로 추정한 쪽 수가 같은 문서 (공개 79 · 비공개 실문서 522 · 기능 시험 문서 780) | 그 문서를 저장한 한/글의 쪽 수 | 1,344 / 1,381 (추정하지 않음 16) |
|
|
127
|
+
줄 배치와 쪽 수 추정은 실험 기능입니다. 정확도 숫자는 측정 스크립트와 기록을 저장소에 함께 실을 수 있을 때 적습니다.
|
|
106
128
|
|
|
107
129
|
**열림: 한컴오피스 12 (macOS)**
|
|
108
130
|
|
|
@@ -118,10 +140,10 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
118
140
|
<p align="center"><sub>ChatGPT 실행 환경에서 만든 문서를 실제 한컴오피스로 연 모습.</sub></p>
|
|
119
141
|
|
|
120
142
|
전체 숫자와 주의할 점은 [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)에,
|
|
121
|
-
기능별 등급은 [지원 매트릭스](docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
143
|
+
기능별 등급은 [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md)에 있습니다. 이 숫자들은 "만든 파일을 한/글이 어떻게
|
|
122
144
|
받는가"를 잰 것이고 파서가 문서를 얼마나 잘 읽는지와는 다른 지표입니다.
|
|
123
145
|
|
|
124
|
-
개발 단계는
|
|
146
|
+
개발 단계는 안정(Production/Stable)입니다. 하위 호환을 지키는 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)에 적혀 있고,
|
|
125
147
|
`hwpx.experimental`과 위에서 "실험"이라고 적은 기능은 바뀔 수 있습니다.
|
|
126
148
|
|
|
127
149
|
## 어디서 쓰나
|
|
@@ -129,8 +151,8 @@ ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽
|
|
|
129
151
|
| 환경 | 방법 |
|
|
130
152
|
|---|---|
|
|
131
153
|
| 로컬·서버 파이썬 | `pip install python-hwpx` (스크립트·배치·CI) |
|
|
132
|
-
| 파이썬 자동화 (MCP 없이) | `pip install python-hwpx-automation` (저작·양식 채움·검증 워크플로) |
|
|
133
|
-
| 일반 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)) |
|
|
134
156
|
| ChatGPT MCP 앱 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)의 MCP adapter를 커넥터로 등록 |
|
|
135
157
|
| Codex 마켓플레이스 플러그인 | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) 설치 |
|
|
136
158
|
| Claude Code · Hermes · OpenClaw | 같은 MCP 서버를 각 클라이언트에 등록 ([`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)) |
|
|
@@ -150,7 +172,7 @@ ChatGPT 채팅의 파이썬 환경은 PyPI에 접속하지 못합니다. 그래
|
|
|
150
172
|
```
|
|
151
173
|
|
|
152
174
|
설치부터 결과 파일까지 대화 안에서 끝나므로 내 컴퓨터에 파이썬이 없어도 됩니다. wheel의 의존성은 `lxml`
|
|
153
|
-
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](docs/ai-assistants.md)에,
|
|
175
|
+
하나이고 실행 환경에 없으면 lxml wheel도 함께 올립니다. 에이전트용 지시문은 [AI 채팅 환경에서 쓰기](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)에,
|
|
154
176
|
AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.github.io/python-hwpx/llms.txt)도 있습니다.
|
|
155
177
|
|
|
156
178
|
| | 저장소 | 역할 |
|
|
@@ -163,19 +185,19 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
163
185
|
|
|
164
186
|
| | python-hwpx | pyhwpx | pyhwp |
|
|
165
187
|
|---|---|---|---|
|
|
166
|
-
| **다루는 형식** | `.hwpx
|
|
188
|
+
| **다루는 형식** | `.hwpx` 읽기·쓰기, `.hwp` (HWP 5.0) 읽기 | `.hwpx` | `.hwp` (v5 바이너리) |
|
|
167
189
|
| **한/글 설치** | 필요 없음 | 필요 (Windows COM) | 필요 없음 |
|
|
168
190
|
| **운영체제** | Linux / macOS / Windows / CI | Windows 전용 | Linux / macOS / Windows |
|
|
169
191
|
| **편집·생성** | ✅ | ✅ (한/글이 함) | 대부분 읽기 |
|
|
170
192
|
| **한/글 없이 쪽 수 추정** | ✅ (실험) | 한/글이 계산 | ❌ |
|
|
171
|
-
| **AI 에이전트 연동 (MCP)** | ✅ (automation 경유) | ❌ | ❌ |
|
|
172
193
|
|
|
173
194
|
## 알려진 제약
|
|
174
195
|
|
|
175
|
-
- `add_shape()
|
|
176
|
-
경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는
|
|
177
|
-
`
|
|
178
|
-
`
|
|
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()`를 쓰세요.
|
|
179
201
|
- 그림은 밝기·대비·회색조·흑백·투명도, 실선 테두리, 자르기(`crop`), 그림자·빛남·부드러운 가장자리·반사
|
|
180
202
|
(`shadow`·`glow`·`soft_edge`·`reflection`)를 `add_picture()` 인자로 줄 수 있습니다. 뒤집기와 회전은 아직 안 됩니다.
|
|
181
203
|
- 쪽 수 추정과 줄 배치 정보 쓰기는 실험 기능입니다. 따르지 못하는 요소가 있으면 추정하지 않고 까닭을 돌려줍니다.
|
|
@@ -189,11 +211,11 @@ AI 도구가 API를 정확히 익히도록 만든 [llms.txt](https://airmang.git
|
|
|
189
211
|
[help wanted](https://github.com/airmang/python-hwpx/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) ·
|
|
190
212
|
[로드맵](https://github.com/airmang/python-hwpx/milestones) ·
|
|
191
213
|
[Discussions](https://github.com/airmang/python-hwpx/discussions) ·
|
|
192
|
-
[CONTRIBUTING](CONTRIBUTING.md)
|
|
214
|
+
[CONTRIBUTING](https://github.com/airmang/python-hwpx/blob/main/CONTRIBUTING.md)
|
|
193
215
|
|
|
194
|
-
HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals
|
|
195
|
-
캐시, 목차 필드, OPC 재압축 같은 내용을 정리해 두었습니다. 공개 API의 안정 범위는 [안정 API 표면](docs/stable-api.md),
|
|
196
|
-
계층 사이의 소유권은 [제품 경계 문서](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)에 있습니다.
|
|
197
219
|
|
|
198
220
|
## 감사의 말
|
|
199
221
|
|
|
@@ -207,4 +229,4 @@ HWPX 내부 구조가 처음이라면 [내부 실전 가이드](docs/internals/)
|
|
|
207
229
|
|
|
208
230
|
## License · Maintainer
|
|
209
231
|
|
|
210
|
-
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)
|