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.
Files changed (560) hide show
  1. python_hwpx-7.0.0/MANIFEST.in +8 -0
  2. {python_hwpx-6.12.0/src/python_hwpx.egg-info → python_hwpx-7.0.0}/PKG-INFO +81 -59
  3. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/README.md +75 -53
  4. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/pyproject.toml +54 -35
  5. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/__init__.py +114 -65
  6. python_hwpx-7.0.0/src/hwpx/_document/_legacy.py +84 -0
  7. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/_resolve.py +115 -24
  8. python_hwpx-7.0.0/src/hwpx/_document/_units.py +42 -0
  9. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/fields.py +881 -51
  10. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/headings.py +5 -13
  11. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/highlight.py +64 -5
  12. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/layout.py +311 -222
  13. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/media.py +254 -81
  14. python_hwpx-7.0.0/src/hwpx/_document/memos.py +520 -0
  15. python_hwpx-7.0.0/src/hwpx/_document/ns/_base.py +111 -0
  16. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/fields.py +170 -20
  17. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/media.py +32 -15
  18. python_hwpx-7.0.0/src/hwpx/_document/ns/notes.py +289 -0
  19. python_hwpx-7.0.0/src/hwpx/_document/ns/page.py +1292 -0
  20. python_hwpx-7.0.0/src/hwpx/_document/ns/parts.py +552 -0
  21. python_hwpx-7.0.0/src/hwpx/_document/ns/refs.py +190 -0
  22. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/shapes.py +198 -122
  23. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/styles.py +536 -175
  24. python_hwpx-7.0.0/src/hwpx/_document/ns/tables.py +172 -0
  25. python_hwpx-7.0.0/src/hwpx/_document/ns/text.py +627 -0
  26. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/tracking.py +67 -16
  27. python_hwpx-7.0.0/src/hwpx/_document/persistence.py +870 -0
  28. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/shapes.py +183 -119
  29. python_hwpx-7.0.0/src/hwpx/_document/text_blocks.py +911 -0
  30. python_hwpx-7.0.0/src/hwpx/_document/tracked.py +699 -0
  31. python_hwpx-7.0.0/src/hwpx/_moved_modules.py +324 -0
  32. python_hwpx-7.0.0/src/hwpx/_removed_names.py +1235 -0
  33. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/capabilities.py +54 -79
  34. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/known-traps.md +29 -12
  35. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/mutation-semantics.md +14 -11
  36. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/recipes-traversal.md +8 -8
  37. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/contract_docs/support-matrix.md +28 -28
  38. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/document.py +431 -266
  39. python_hwpx-7.0.0/src/hwpx/equation/__init__.py +47 -0
  40. python_hwpx-7.0.0/src/hwpx/equation/authoring.py +807 -0
  41. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/equation/eqedit.py +163 -15
  42. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/equation/measure.py +208 -42
  43. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/equation/tokens.py +84 -0
  44. python_hwpx-7.0.0/src/hwpx/errors.py +782 -0
  45. python_hwpx-7.0.0/src/hwpx/experimental.py +76 -0
  46. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/__init__.py +7 -1
  47. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/measure.py +4 -2
  48. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/cfb.py +37 -0
  49. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/docinfo.py +8 -6
  50. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/docinfo_writer.py +12 -7
  51. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/header_xml.py +75 -18
  52. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/owpml.py +7 -0
  53. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/package.py +79 -9
  54. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/reader.py +3 -5
  55. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/records.py +19 -5
  56. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_writer.py +21 -0
  57. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_xml.py +170 -30
  58. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/shape_xml.py +2 -2
  59. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/_page_measure.py +10 -3
  60. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/lint.py +5 -5
  61. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/model.py +7 -1
  62. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/mutation_report.py +123 -14
  63. python_hwpx-7.0.0/src/hwpx/objects/__init__.py +275 -0
  64. python_hwpx-7.0.0/src/hwpx/objects/binary_item.py +34 -0
  65. python_hwpx-7.0.0/src/hwpx/objects/checkbox.py +392 -0
  66. python_hwpx-7.0.0/src/hwpx/objects/form_field.py +1117 -0
  67. python_hwpx-7.0.0/src/hwpx/objects/highlight.py +283 -0
  68. python_hwpx-7.0.0/src/hwpx/objects/results.py +1182 -0
  69. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/opc/package.py +925 -142
  70. python_hwpx-7.0.0/src/hwpx/opc/security.py +502 -0
  71. python_hwpx-7.0.0/src/hwpx/opc/xml_utils.py +354 -0
  72. python_hwpx-7.0.0/src/hwpx/opc/zip_records.py +262 -0
  73. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/__init__.py +5 -2
  74. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/_document_impl.py +1 -1
  75. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/_document_primitives.py +424 -99
  76. python_hwpx-7.0.0/src/hwpx/oxml/_paragraph_text_edit.py +1470 -0
  77. python_hwpx-7.0.0/src/hwpx/oxml/caret.py +169 -0
  78. python_hwpx-7.0.0/src/hwpx/oxml/container.py +1218 -0
  79. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/curves.py +71 -13
  80. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document_metadata.py +52 -4
  81. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document_parts.py +243 -134
  82. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/drop_cap.py +7 -5
  83. python_hwpx-7.0.0/src/hwpx/oxml/dutmal_compose.py +372 -0
  84. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/field_marks.py +181 -18
  85. python_hwpx-7.0.0/src/hwpx/oxml/formatting.py +1640 -0
  86. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header.py +90 -24
  87. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_fonts.py +180 -33
  88. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_part.py +278 -99
  89. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/hyperlink_form.py +117 -1
  90. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/master_page_authoring.py +79 -4
  91. python_hwpx-7.0.0/src/hwpx/oxml/memo.py +1172 -0
  92. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/namespaces.py +41 -0
  93. python_hwpx-7.0.0/src/hwpx/oxml/note_authoring.py +606 -0
  94. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/numbering.py +2 -13
  95. python_hwpx-7.0.0/src/hwpx/oxml/numbering_kinds.py +569 -0
  96. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/objects.py +568 -204
  97. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/paragraph.py +588 -207
  98. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/paragraph_heading.py +50 -0
  99. python_hwpx-7.0.0/src/hwpx/oxml/run.py +1484 -0
  100. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section.py +512 -62
  101. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_format.py +311 -215
  102. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_layout.py +4 -2
  103. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/section_story.py +216 -67
  104. python_hwpx-7.0.0/src/hwpx/oxml/shape_position.py +3139 -0
  105. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/simple_parts.py +86 -0
  106. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table.py +210 -144
  107. python_hwpx-7.0.0/src/hwpx/oxml/table_format.py +1048 -0
  108. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table_merge.py +64 -1
  109. python_hwpx-7.0.0/src/hwpx/oxml/table_rows.py +280 -0
  110. python_hwpx-7.0.0/src/hwpx/oxml/table_sizes.py +1044 -0
  111. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/table_structure.py +135 -16
  112. python_hwpx-7.0.0/src/hwpx/oxml/text_offsets.py +104 -0
  113. python_hwpx-7.0.0/src/hwpx/oxml/text_ranges.py +1506 -0
  114. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/utils.py +39 -2
  115. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/patch.py +268 -207
  116. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/__init__.py +4 -4
  117. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/policy.py +1 -1
  118. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/save_pipeline.py +155 -28
  119. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/table_patch.py +20 -9
  120. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/__init__.py +15 -91
  121. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/archive_cli.py +76 -0
  122. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/doc_diff.py +20 -125
  123. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/document_merge.py +601 -77
  124. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/exporter.py +194 -181
  125. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/generic_inventory.py +2 -0
  126. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/ir_equality.py +9 -2
  127. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/package_validator.py +122 -31
  128. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/page_guard.py +11 -1
  129. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/redline.py +15 -5
  130. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/repair.py +70 -1
  131. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/table_navigation.py +14 -274
  132. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/template_analyzer.py +7 -2
  133. python_hwpx-7.0.0/src/hwpx/tools/text_extract_cli.py +135 -0
  134. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/text_extractor.py +27 -7
  135. python_hwpx-7.0.0/src/hwpx/tools/toc_author.py +921 -0
  136. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/validator.py +51 -11
  137. {python_hwpx-6.12.0 → python_hwpx-7.0.0/src/python_hwpx.egg-info}/PKG-INFO +81 -59
  138. python_hwpx-7.0.0/src/python_hwpx.egg-info/SOURCES.txt +208 -0
  139. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/entry_points.txt +0 -1
  140. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/requires.txt +4 -4
  141. python_hwpx-6.12.0/src/hwpx/_document/_legacy.py +0 -1762
  142. python_hwpx-6.12.0/src/hwpx/_document/_units.py +0 -16
  143. python_hwpx-6.12.0/src/hwpx/_document/memos.py +0 -328
  144. python_hwpx-6.12.0/src/hwpx/_document/ns/_base.py +0 -40
  145. python_hwpx-6.12.0/src/hwpx/_document/ns/notes.py +0 -210
  146. python_hwpx-6.12.0/src/hwpx/_document/ns/page.py +0 -615
  147. python_hwpx-6.12.0/src/hwpx/_document/ns/parts.py +0 -374
  148. python_hwpx-6.12.0/src/hwpx/_document/ns/refs.py +0 -86
  149. python_hwpx-6.12.0/src/hwpx/_document/ns/tables.py +0 -132
  150. python_hwpx-6.12.0/src/hwpx/_document/ns/text.py +0 -391
  151. python_hwpx-6.12.0/src/hwpx/_document/persistence.py +0 -545
  152. python_hwpx-6.12.0/src/hwpx/_document/text_blocks.py +0 -385
  153. python_hwpx-6.12.0/src/hwpx/_document/tracked.py +0 -290
  154. python_hwpx-6.12.0/src/hwpx/_moved_modules.py +0 -118
  155. python_hwpx-6.12.0/src/hwpx/equation/__init__.py +0 -54
  156. python_hwpx-6.12.0/src/hwpx/equation/authoring.py +0 -475
  157. python_hwpx-6.12.0/src/hwpx/equation/mathml.py +0 -157
  158. python_hwpx-6.12.0/src/hwpx/equation/render.py +0 -83
  159. python_hwpx-6.12.0/src/hwpx/errors.py +0 -454
  160. python_hwpx-6.12.0/src/hwpx/experimental.py +0 -84
  161. python_hwpx-6.12.0/src/hwpx/ingest/__init__.py +0 -26
  162. python_hwpx-6.12.0/src/hwpx/ingest/base.py +0 -236
  163. python_hwpx-6.12.0/src/hwpx/ingest/hwpx_converter.py +0 -290
  164. python_hwpx-6.12.0/src/hwpx/objects/__init__.py +0 -73
  165. python_hwpx-6.12.0/src/hwpx/objects/binary_item.py +0 -58
  166. python_hwpx-6.12.0/src/hwpx/objects/checkbox.py +0 -103
  167. python_hwpx-6.12.0/src/hwpx/objects/form_field.py +0 -348
  168. python_hwpx-6.12.0/src/hwpx/objects/highlight.py +0 -41
  169. python_hwpx-6.12.0/src/hwpx/objects/results.py +0 -373
  170. python_hwpx-6.12.0/src/hwpx/opc/security.py +0 -240
  171. python_hwpx-6.12.0/src/hwpx/opc/xml_utils.py +0 -165
  172. python_hwpx-6.12.0/src/hwpx/oxml/_paragraph_text_edit.py +0 -188
  173. python_hwpx-6.12.0/src/hwpx/oxml/container.py +0 -377
  174. python_hwpx-6.12.0/src/hwpx/oxml/dutmal_compose.py +0 -134
  175. python_hwpx-6.12.0/src/hwpx/oxml/memo.py +0 -567
  176. python_hwpx-6.12.0/src/hwpx/oxml/note_authoring.py +0 -194
  177. python_hwpx-6.12.0/src/hwpx/oxml/numbering_kinds.py +0 -178
  178. python_hwpx-6.12.0/src/hwpx/oxml/run.py +0 -668
  179. python_hwpx-6.12.0/src/hwpx/oxml/shape_position.py +0 -600
  180. python_hwpx-6.12.0/src/hwpx/oxml/table_sizes.py +0 -538
  181. python_hwpx-6.12.0/src/hwpx/tools/document_viewer.py +0 -182
  182. python_hwpx-6.12.0/src/hwpx/tools/format_rules.py +0 -530
  183. python_hwpx-6.12.0/src/hwpx/tools/layout_preview.py +0 -752
  184. python_hwpx-6.12.0/src/hwpx/tools/mail_merge.py +0 -518
  185. python_hwpx-6.12.0/src/hwpx/tools/markdown_export.py +0 -647
  186. python_hwpx-6.12.0/src/hwpx/tools/markdown_import.py +0 -473
  187. python_hwpx-6.12.0/src/hwpx/tools/report_utils.py +0 -132
  188. python_hwpx-6.12.0/src/hwpx/tools/table_cleanup.py +0 -61
  189. python_hwpx-6.12.0/src/hwpx/tools/text_extract_cli.py +0 -67
  190. python_hwpx-6.12.0/src/hwpx/tools/toc_author.py +0 -475
  191. python_hwpx-6.12.0/src/python_hwpx.egg-info/SOURCES.txt +0 -511
  192. python_hwpx-6.12.0/tests/test_add_control.py +0 -83
  193. python_hwpx-6.12.0/tests/test_add_heading.py +0 -355
  194. python_hwpx-6.12.0/tests/test_adoption_metrics_snapshot.py +0 -90
  195. python_hwpx-6.12.0/tests/test_append_paragraph_cost.py +0 -61
  196. python_hwpx-6.12.0/tests/test_arc_authoring.py +0 -294
  197. python_hwpx-6.12.0/tests/test_authoring_defaults.py +0 -412
  198. python_hwpx-6.12.0/tests/test_authoring_quality_corpus.py +0 -514
  199. python_hwpx-6.12.0/tests/test_blind_eval_fixture.py +0 -155
  200. python_hwpx-6.12.0/tests/test_body_patch.py +0 -190
  201. python_hwpx-6.12.0/tests/test_body_patch_color_runs.py +0 -197
  202. python_hwpx-6.12.0/tests/test_body_patch_ops.py +0 -461
  203. python_hwpx-6.12.0/tests/test_border_fill_image_gradient.py +0 -361
  204. python_hwpx-6.12.0/tests/test_border_line_types.py +0 -72
  205. python_hwpx-6.12.0/tests/test_build_element_census.py +0 -186
  206. python_hwpx-6.12.0/tests/test_byte_patch_identity.py +0 -314
  207. python_hwpx-6.12.0/tests/test_capabilities_surface.py +0 -198
  208. python_hwpx-6.12.0/tests/test_cell_border_neighbors.py +0 -135
  209. python_hwpx-6.12.0/tests/test_cell_edit_holder_cache.py +0 -101
  210. python_hwpx-6.12.0/tests/test_cell_fields.py +0 -224
  211. python_hwpx-6.12.0/tests/test_cell_line_spacing.py +0 -177
  212. python_hwpx-6.12.0/tests/test_cell_margins.py +0 -311
  213. python_hwpx-6.12.0/tests/test_cell_text_rewrite_semantics.py +0 -145
  214. python_hwpx-6.12.0/tests/test_char_pr_child_order.py +0 -64
  215. python_hwpx-6.12.0/tests/test_character_width_ratio.py +0 -35
  216. python_hwpx-6.12.0/tests/test_chart_authoring.py +0 -313
  217. python_hwpx-6.12.0/tests/test_check_box_authoring.py +0 -154
  218. python_hwpx-6.12.0/tests/test_color_arguments.py +0 -170
  219. python_hwpx-6.12.0/tests/test_column_break.py +0 -109
  220. python_hwpx-6.12.0/tests/test_column_widths_as_shares.py +0 -119
  221. python_hwpx-6.12.0/tests/test_comment_node_robustness.py +0 -85
  222. python_hwpx-6.12.0/tests/test_container_authoring.py +0 -352
  223. python_hwpx-6.12.0/tests/test_container_members.py +0 -216
  224. python_hwpx-6.12.0/tests/test_contract_docs_sync.py +0 -41
  225. python_hwpx-6.12.0/tests/test_corpus_read_fidelity.py +0 -38
  226. python_hwpx-6.12.0/tests/test_coverage_ledger.py +0 -1104
  227. python_hwpx-6.12.0/tests/test_coverage_promotion.py +0 -671
  228. python_hwpx-6.12.0/tests/test_coverage_targets.py +0 -74
  229. python_hwpx-6.12.0/tests/test_curve_connector_authoring.py +0 -179
  230. python_hwpx-6.12.0/tests/test_dev_extra_matches_ci.py +0 -41
  231. python_hwpx-6.12.0/tests/test_deviations_registry.py +0 -454
  232. python_hwpx-6.12.0/tests/test_distribution_file_sizes.py +0 -89
  233. python_hwpx-6.12.0/tests/test_doc_diff.py +0 -71
  234. python_hwpx-6.12.0/tests/test_document_context_manager.py +0 -65
  235. python_hwpx-6.12.0/tests/test_document_facade_surface.py +0 -87
  236. python_hwpx-6.12.0/tests/test_document_formatting.py +0 -1995
  237. python_hwpx-6.12.0/tests/test_document_merge.py +0 -1318
  238. python_hwpx-6.12.0/tests/test_document_metadata.py +0 -144
  239. python_hwpx-6.12.0/tests/test_document_ops_runtime_boundary.py +0 -256
  240. python_hwpx-6.12.0/tests/test_document_save_api.py +0 -319
  241. python_hwpx-6.12.0/tests/test_document_viewer.py +0 -136
  242. python_hwpx-6.12.0/tests/test_documentation_code_fences.py +0 -531
  243. python_hwpx-6.12.0/tests/test_drop_cap_authoring.py +0 -258
  244. python_hwpx-6.12.0/tests/test_dutmal_compose_authoring.py +0 -238
  245. python_hwpx-6.12.0/tests/test_edit_clears_line_cache.py +0 -199
  246. python_hwpx-6.12.0/tests/test_edit_fidelity_corpus.py +0 -311
  247. python_hwpx-6.12.0/tests/test_edit_plan.py +0 -356
  248. python_hwpx-6.12.0/tests/test_editor_surface_inventory.py +0 -119
  249. python_hwpx-6.12.0/tests/test_engine_small_defects_eng36.py +0 -110
  250. python_hwpx-6.12.0/tests/test_engine_surface_6_0.py +0 -501
  251. python_hwpx-6.12.0/tests/test_ensure_run_font_by_lang.py +0 -248
  252. python_hwpx-6.12.0/tests/test_equalize_widths_per_row.py +0 -297
  253. python_hwpx-6.12.0/tests/test_equation_authoring.py +0 -417
  254. python_hwpx-6.12.0/tests/test_equation_converter.py +0 -301
  255. python_hwpx-6.12.0/tests/test_equation_font_boundaries.py +0 -93
  256. python_hwpx-6.12.0/tests/test_equation_measure_hancom_saved.py +0 -99
  257. python_hwpx-6.12.0/tests/test_equation_render.py +0 -184
  258. python_hwpx-6.12.0/tests/test_equation_size.py +0 -109
  259. python_hwpx-6.12.0/tests/test_equation_width_hancom_boxes.py +0 -73
  260. python_hwpx-6.12.0/tests/test_error_contract.py +0 -235
  261. python_hwpx-6.12.0/tests/test_error_messages.py +0 -143
  262. python_hwpx-6.12.0/tests/test_evalplan_core_primitives.py +0 -71
  263. python_hwpx-6.12.0/tests/test_existing_document_format_editing.py +0 -203
  264. python_hwpx-6.12.0/tests/test_export_captions_dutmal.py +0 -162
  265. python_hwpx-6.12.0/tests/test_export_cell_text_spaces.py +0 -29
  266. python_hwpx-6.12.0/tests/test_export_list_labels.py +0 -194
  267. python_hwpx-6.12.0/tests/test_export_notes.py +0 -202
  268. python_hwpx-6.12.0/tests/test_export_text_boxes.py +0 -157
  269. python_hwpx-6.12.0/tests/test_exporter_table_text.py +0 -164
  270. python_hwpx-6.12.0/tests/test_field_marks.py +0 -328
  271. python_hwpx-6.12.0/tests/test_field_readers.py +0 -158
  272. python_hwpx-6.12.0/tests/test_field_type_ids.py +0 -120
  273. python_hwpx-6.12.0/tests/test_fill_image_hancom_modes.py +0 -73
  274. python_hwpx-6.12.0/tests/test_form_field_authoring.py +0 -221
  275. python_hwpx-6.12.0/tests/test_form_field_fill_cost.py +0 -66
  276. python_hwpx-6.12.0/tests/test_form_fields.py +0 -372
  277. python_hwpx-6.12.0/tests/test_form_fill_core_primitives.py +0 -38
  278. python_hwpx-6.12.0/tests/test_form_fit.py +0 -587
  279. python_hwpx-6.12.0/tests/test_form_fit_hancom_rules.py +0 -2100
  280. python_hwpx-6.12.0/tests/test_form_fit_integration.py +0 -200
  281. python_hwpx-6.12.0/tests/test_format_rules.py +0 -233
  282. python_hwpx-6.12.0/tests/test_fuzz_catalog_derive_expected.py +0 -173
  283. python_hwpx-6.12.0/tests/test_fuzz_loop.py +0 -129
  284. python_hwpx-6.12.0/tests/test_fuzz_regressions.py +0 -56
  285. python_hwpx-6.12.0/tests/test_gap_and_new_number_values.py +0 -143
  286. python_hwpx-6.12.0/tests/test_gap_closure_tools.py +0 -788
  287. python_hwpx-6.12.0/tests/test_glyph_table_data.py +0 -58
  288. python_hwpx-6.12.0/tests/test_golden_api.py +0 -305
  289. python_hwpx-6.12.0/tests/test_header_compat_authoring.py +0 -319
  290. python_hwpx-6.12.0/tests/test_header_control_before_field.py +0 -78
  291. python_hwpx-6.12.0/tests/test_header_list_lookups.py +0 -71
  292. python_hwpx-6.12.0/tests/test_header_lookup_cache.py +0 -91
  293. python_hwpx-6.12.0/tests/test_heading_style_shapes.py +0 -58
  294. python_hwpx-6.12.0/tests/test_highlight_authoring.py +0 -289
  295. python_hwpx-6.12.0/tests/test_hp_tab_support.py +0 -64
  296. python_hwpx-6.12.0/tests/test_hwp5_container.py +0 -255
  297. python_hwpx-6.12.0/tests/test_hwp5_hancom_files.py +0 -163
  298. python_hwpx-6.12.0/tests/test_hwp5_open.py +0 -1387
  299. python_hwpx-6.12.0/tests/test_hwp5_open_errors.py +0 -110
  300. python_hwpx-6.12.0/tests/test_hwp5_save.py +0 -1989
  301. python_hwpx-6.12.0/tests/test_hwp5_scripts_limits.py +0 -60
  302. python_hwpx-6.12.0/tests/test_hwpxlib_corpus_read.py +0 -36
  303. python_hwpx-6.12.0/tests/test_hyperlink_hancom_form.py +0 -110
  304. python_hwpx-6.12.0/tests/test_id_generator_range.py +0 -32
  305. python_hwpx-6.12.0/tests/test_id_integrity.py +0 -54
  306. python_hwpx-6.12.0/tests/test_image_object_workflow.py +0 -294
  307. python_hwpx-6.12.0/tests/test_index_mark.py +0 -158
  308. python_hwpx-6.12.0/tests/test_ingest.py +0 -124
  309. python_hwpx-6.12.0/tests/test_inline_models.py +0 -113
  310. python_hwpx-6.12.0/tests/test_insert_column_by_clone.py +0 -200
  311. python_hwpx-6.12.0/tests/test_insert_row_merged_cells.py +0 -130
  312. python_hwpx-6.12.0/tests/test_insert_row_sides.py +0 -193
  313. python_hwpx-6.12.0/tests/test_instid_attribute_case.py +0 -126
  314. python_hwpx-6.12.0/tests/test_integration_hwpx_compatibility.py +0 -228
  315. python_hwpx-6.12.0/tests/test_integration_roundtrip.py +0 -327
  316. python_hwpx-6.12.0/tests/test_internal_calls_skip_moved_names.py +0 -77
  317. python_hwpx-6.12.0/tests/test_known_leak_migration_contract.py +0 -94
  318. python_hwpx-6.12.0/tests/test_layer_leak_guard.py +0 -181
  319. python_hwpx-6.12.0/tests/test_layout_cache_scope.py +0 -293
  320. python_hwpx-6.12.0/tests/test_layout_line_cache.py +0 -991
  321. python_hwpx-6.12.0/tests/test_layout_lint.py +0 -816
  322. python_hwpx-6.12.0/tests/test_layout_page_estimate.py +0 -2995
  323. python_hwpx-6.12.0/tests/test_layout_pages_split.py +0 -64
  324. python_hwpx-6.12.0/tests/test_layout_preview.py +0 -60
  325. python_hwpx-6.12.0/tests/test_lazy_hwp5_import.py +0 -87
  326. python_hwpx-6.12.0/tests/test_lazy_tools_import.py +0 -91
  327. python_hwpx-6.12.0/tests/test_lazy_tools_submodules.py +0 -149
  328. python_hwpx-6.12.0/tests/test_library_boundary_closure.py +0 -195
  329. python_hwpx-6.12.0/tests/test_line_break_writing.py +0 -214
  330. python_hwpx-6.12.0/tests/test_line_width_arguments.py +0 -94
  331. python_hwpx-6.12.0/tests/test_list_continue.py +0 -112
  332. python_hwpx-6.12.0/tests/test_list_defaults_vs_hancom.py +0 -80
  333. python_hwpx-6.12.0/tests/test_list_level_range.py +0 -53
  334. python_hwpx-6.12.0/tests/test_llms_txt.py +0 -124
  335. python_hwpx-6.12.0/tests/test_mail_merge_xlsx.py +0 -38
  336. python_hwpx-6.12.0/tests/test_manifest_resolve_once.py +0 -52
  337. python_hwpx-6.12.0/tests/test_markdown_export.py +0 -436
  338. python_hwpx-6.12.0/tests/test_markdown_export_shape_text.py +0 -75
  339. python_hwpx-6.12.0/tests/test_markdown_import.py +0 -208
  340. python_hwpx-6.12.0/tests/test_master_page_authoring.py +0 -181
  341. python_hwpx-6.12.0/tests/test_master_page_pages_taken.py +0 -181
  342. python_hwpx-6.12.0/tests/test_memo_and_style_editing.py +0 -474
  343. python_hwpx-6.12.0/tests/test_memo_fields.py +0 -124
  344. python_hwpx-6.12.0/tests/test_memo_shape_authoring.py +0 -249
  345. python_hwpx-6.12.0/tests/test_merge_cells_hancom_files.py +0 -46
  346. python_hwpx-6.12.0/tests/test_merge_cells_keeps_contents.py +0 -180
  347. python_hwpx-6.12.0/tests/test_migration_seams.py +0 -116
  348. python_hwpx-6.12.0/tests/test_moved_module_imports.py +0 -105
  349. python_hwpx-6.12.0/tests/test_moved_surface_hints.py +0 -66
  350. python_hwpx-6.12.0/tests/test_mutation_report.py +0 -343
  351. python_hwpx-6.12.0/tests/test_namespace_handling.py +0 -134
  352. python_hwpx-6.12.0/tests/test_namespace_hygiene.py +0 -192
  353. python_hwpx-6.12.0/tests/test_namespace_normalization.py +0 -109
  354. python_hwpx-6.12.0/tests/test_native_edit_contract.py +0 -338
  355. python_hwpx-6.12.0/tests/test_nested_cell_fill_safety.py +0 -301
  356. python_hwpx-6.12.0/tests/test_nested_table_structure_edits.py +0 -259
  357. python_hwpx-6.12.0/tests/test_new_features.py +0 -593
  358. python_hwpx-6.12.0/tests/test_note_authoring_contract.py +0 -121
  359. python_hwpx-6.12.0/tests/test_ns_fields.py +0 -157
  360. python_hwpx-6.12.0/tests/test_ns_media.py +0 -94
  361. python_hwpx-6.12.0/tests/test_ns_notes.py +0 -120
  362. python_hwpx-6.12.0/tests/test_ns_page.py +0 -284
  363. python_hwpx-6.12.0/tests/test_ns_refs.py +0 -77
  364. python_hwpx-6.12.0/tests/test_ns_shapes.py +0 -198
  365. python_hwpx-6.12.0/tests/test_ns_tables.py +0 -130
  366. python_hwpx-6.12.0/tests/test_ns_tracking.py +0 -139
  367. python_hwpx-6.12.0/tests/test_number_formats.py +0 -132
  368. python_hwpx-6.12.0/tests/test_opc_package.py +0 -969
  369. python_hwpx-6.12.0/tests/test_open_damaged_input.py +0 -158
  370. python_hwpx-6.12.0/tests/test_open_safety_corpus.py +0 -88
  371. python_hwpx-6.12.0/tests/test_outline_numbering.py +0 -120
  372. python_hwpx-6.12.0/tests/test_oxml_modularization.py +0 -453
  373. python_hwpx-6.12.0/tests/test_oxml_parsing.py +0 -385
  374. python_hwpx-6.12.0/tests/test_package_hygiene.py +0 -558
  375. python_hwpx-6.12.0/tests/test_package_text_and_namespaces.py +0 -291
  376. python_hwpx-6.12.0/tests/test_packaging_license_metadata.py +0 -63
  377. python_hwpx-6.12.0/tests/test_packaging_py_typed.py +0 -42
  378. python_hwpx-6.12.0/tests/test_page_and_list_values.py +0 -161
  379. python_hwpx-6.12.0/tests/test_page_number_control.py +0 -323
  380. python_hwpx-6.12.0/tests/test_page_number_format.py +0 -73
  381. python_hwpx-6.12.0/tests/test_page_orientation.py +0 -157
  382. python_hwpx-6.12.0/tests/test_para_pr_dedup.py +0 -133
  383. python_hwpx-6.12.0/tests/test_paragraph_align_distribute_space.py +0 -41
  384. python_hwpx-6.12.0/tests/test_paragraph_border.py +0 -168
  385. python_hwpx-6.12.0/tests/test_paragraph_format_targets.py +0 -218
  386. python_hwpx-6.12.0/tests/test_paragraph_hyperlink_style.py +0 -127
  387. python_hwpx-6.12.0/tests/test_paragraph_keep_together.py +0 -46
  388. python_hwpx-6.12.0/tests/test_paragraph_margin_default_scale.py +0 -89
  389. python_hwpx-6.12.0/tests/test_paragraph_matcher.py +0 -126
  390. python_hwpx-6.12.0/tests/test_paragraph_property_lookup.py +0 -82
  391. python_hwpx-6.12.0/tests/test_paragraph_property_version_switch.py +0 -160
  392. python_hwpx-6.12.0/tests/test_paragraph_remove_in_containers.py +0 -133
  393. python_hwpx-6.12.0/tests/test_paragraph_section_management.py +0 -459
  394. python_hwpx-6.12.0/tests/test_part_hierarchy_read_models.py +0 -250
  395. python_hwpx-6.12.0/tests/test_picture_adjustments.py +0 -256
  396. python_hwpx-6.12.0/tests/test_polygon_authoring.py +0 -368
  397. python_hwpx-6.12.0/tests/test_preview_and_markdown_untrusted_values.py +0 -171
  398. python_hwpx-6.12.0/tests/test_product_boundary.py +0 -923
  399. python_hwpx-6.12.0/tests/test_public_artifact_hygiene.py +0 -570
  400. python_hwpx-6.12.0/tests/test_public_exceptions_inherit_hwpx_error.py +0 -48
  401. python_hwpx-6.12.0/tests/test_public_runtime_boundary.py +0 -12
  402. python_hwpx-6.12.0/tests/test_read_fidelity.py +0 -170
  403. python_hwpx-6.12.0/tests/test_recover_broken_zip.py +0 -332
  404. python_hwpx-6.12.0/tests/test_redline_authoring.py +0 -349
  405. python_hwpx-6.12.0/tests/test_redline_verify.py +0 -130
  406. python_hwpx-6.12.0/tests/test_release_checklist_example.py +0 -37
  407. python_hwpx-6.12.0/tests/test_release_workflow_safety.py +0 -1182
  408. python_hwpx-6.12.0/tests/test_remove_unused_charts.py +0 -104
  409. python_hwpx-6.12.0/tests/test_remove_unused_images.py +0 -84
  410. python_hwpx-6.12.0/tests/test_repair_repack.py +0 -347
  411. python_hwpx-6.12.0/tests/test_replace_text_barriers.py +0 -113
  412. python_hwpx-6.12.0/tests/test_report_utils.py +0 -56
  413. python_hwpx-6.12.0/tests/test_repr_snapshots.py +0 -68
  414. python_hwpx-6.12.0/tests/test_return_contract.py +0 -523
  415. python_hwpx-6.12.0/tests/test_roundtrip_fidelity.py +0 -92
  416. python_hwpx-6.12.0/tests/test_roundtrip_fidelity_corpus.py +0 -47
  417. python_hwpx-6.12.0/tests/test_row_heights.py +0 -76
  418. python_hwpx-6.12.0/tests/test_run_choice_atom_authoring.py +0 -174
  419. python_hwpx-6.12.0/tests/test_run_content_kinds.py +0 -117
  420. python_hwpx-6.12.0/tests/test_run_font_refs.py +0 -53
  421. python_hwpx-6.12.0/tests/test_run_style_base.py +0 -100
  422. python_hwpx-6.12.0/tests/test_safe_edit_example.py +0 -129
  423. python_hwpx-6.12.0/tests/test_save_keeps_inline_text_caches.py +0 -78
  424. python_hwpx-6.12.0/tests/test_save_pipeline.py +0 -322
  425. python_hwpx-6.12.0/tests/test_save_verifies_once.py +0 -62
  426. python_hwpx-6.12.0/tests/test_save_with_comment_nodes.py +0 -122
  427. python_hwpx-6.12.0/tests/test_section_clear_body.py +0 -611
  428. python_hwpx-6.12.0/tests/test_section_columns.py +0 -247
  429. python_hwpx-6.12.0/tests/test_section_headers.py +0 -383
  430. python_hwpx-6.12.0/tests/test_section_ids_order.py +0 -136
  431. python_hwpx-6.12.0/tests/test_section_properties_real_roundtrip.py +0 -101
  432. python_hwpx-6.12.0/tests/test_set_column_widths_uniform_split.py +0 -65
  433. python_hwpx-6.12.0/tests/test_set_paragraph_format_keep.py +0 -73
  434. python_hwpx-6.12.0/tests/test_shape_geometry_contract.py +0 -353
  435. python_hwpx-6.12.0/tests/test_shape_open_safety_risk_check.py +0 -213
  436. python_hwpx-6.12.0/tests/test_shape_original_size.py +0 -167
  437. python_hwpx-6.12.0/tests/test_shape_position_frames.py +0 -355
  438. python_hwpx-6.12.0/tests/test_shape_size_values.py +0 -212
  439. python_hwpx-6.12.0/tests/test_size_ratchet.py +0 -102
  440. python_hwpx-6.12.0/tests/test_skeleton_template_ids.py +0 -25
  441. python_hwpx-6.12.0/tests/test_split_cell.py +0 -229
  442. python_hwpx-6.12.0/tests/test_split_merged_cell.py +0 -188
  443. python_hwpx-6.12.0/tests/test_stable_surface.py +0 -357
  444. python_hwpx-6.12.0/tests/test_stale_layout_cache_sweep.py +0 -197
  445. python_hwpx-6.12.0/tests/test_story_edits_reach_control_copy.py +0 -256
  446. python_hwpx-6.12.0/tests/test_style_font_border_reads.py +0 -830
  447. python_hwpx-6.12.0/tests/test_style_resolution.py +0 -348
  448. python_hwpx-6.12.0/tests/test_styles_definition_verbs.py +0 -98
  449. python_hwpx-6.12.0/tests/test_tab_character_writing.py +0 -107
  450. python_hwpx-6.12.0/tests/test_tab_definition_version_switch.py +0 -230
  451. python_hwpx-6.12.0/tests/test_table_cell_equalize.py +0 -93
  452. python_hwpx-6.12.0/tests/test_table_cleanup.py +0 -49
  453. python_hwpx-6.12.0/tests/test_table_clone_identities.py +0 -210
  454. python_hwpx-6.12.0/tests/test_table_column_floor.py +0 -119
  455. python_hwpx-6.12.0/tests/test_table_grid_cache.py +0 -127
  456. python_hwpx-6.12.0/tests/test_table_label.py +0 -150
  457. python_hwpx-6.12.0/tests/test_table_navigation.py +0 -242
  458. python_hwpx-6.12.0/tests/test_table_ops_cells_without_geometry.py +0 -61
  459. python_hwpx-6.12.0/tests/test_table_ops_delete_every_line.py +0 -44
  460. python_hwpx-6.12.0/tests/test_table_ops_delete_zones.py +0 -74
  461. python_hwpx-6.12.0/tests/test_table_page_flow.py +0 -57
  462. python_hwpx-6.12.0/tests/test_table_patch.py +0 -602
  463. python_hwpx-6.12.0/tests/test_table_patch_dryrun.py +0 -64
  464. python_hwpx-6.12.0/tests/test_table_patch_m105.py +0 -271
  465. python_hwpx-6.12.0/tests/test_table_patch_structure_fixes.py +0 -224
  466. python_hwpx-6.12.0/tests/test_table_split_merge.py +0 -258
  467. python_hwpx-6.12.0/tests/test_table_structure_edits.py +0 -416
  468. python_hwpx-6.12.0/tests/test_tables_default_border.py +0 -81
  469. python_hwpx-6.12.0/tests/test_template_analyzer_enrichment.py +0 -97
  470. python_hwpx-6.12.0/tests/test_text_blocks.py +0 -223
  471. python_hwpx-6.12.0/tests/test_text_box_fields.py +0 -87
  472. python_hwpx-6.12.0/tests/test_text_extractor_annotations.py +0 -126
  473. python_hwpx-6.12.0/tests/test_text_extractor_nested_once.py +0 -107
  474. python_hwpx-6.12.0/tests/test_text_extractor_run_choice_atoms.py +0 -160
  475. python_hwpx-6.12.0/tests/test_text_inline_elements.py +0 -180
  476. python_hwpx-6.12.0/tests/test_text_replace_everywhere.py +0 -211
  477. python_hwpx-6.12.0/tests/test_title_mark.py +0 -133
  478. python_hwpx-6.12.0/tests/test_toc_author.py +0 -304
  479. python_hwpx-6.12.0/tests/test_toc_fidelity.py +0 -250
  480. python_hwpx-6.12.0/tests/test_tools_untrusted_xml.py +0 -74
  481. python_hwpx-6.12.0/tests/test_tracked_overlap_render_smoke.py +0 -112
  482. python_hwpx-6.12.0/tests/test_tracked_paragraph_delete_break.py +0 -47
  483. python_hwpx-6.12.0/tests/test_trailing_table_text.py +0 -153
  484. python_hwpx-6.12.0/tests/test_validation_severity.py +0 -52
  485. python_hwpx-6.12.0/tests/test_validator_comment_nodes.py +0 -56
  486. python_hwpx-6.12.0/tests/test_validator_form_parameters.py +0 -96
  487. python_hwpx-6.12.0/tests/test_validator_full_schema.py +0 -152
  488. python_hwpx-6.12.0/tests/test_validator_hancom_open_rules.py +0 -313
  489. python_hwpx-6.12.0/tests/test_validator_section_ids.py +0 -141
  490. python_hwpx-6.12.0/tests/test_version_metadata.py +0 -34
  491. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/LICENSE +0 -0
  492. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/NOTICE +0 -0
  493. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/setup.cfg +0 -0
  494. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/__init__.py +0 -0
  495. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_document/ns/__init__.py +0 -0
  496. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/_trailing_table_text.py +0 -0
  497. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/body_patch.py +0 -0
  498. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/data/Skeleton.hwpx +0 -0
  499. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/_glyph_table.json.gz +0 -0
  500. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/_glyph_table.py +0 -0
  501. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/apply.py +0 -0
  502. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/engine.py +0 -0
  503. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/policy.py +0 -0
  504. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/form_fit/report.py +0 -0
  505. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/__init__.py +0 -0
  506. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/binary.py +0 -0
  507. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/bodytext.py +0 -0
  508. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/controls.py +0 -0
  509. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/errors.py +0 -0
  510. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/fileheader.py +0 -0
  511. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/section_common.py +0 -0
  512. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/shapes.py +0 -0
  513. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/summary.py +0 -0
  514. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/hwp5/writer.py +0 -0
  515. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/__init__.py +0 -0
  516. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/line_cache.py +0 -0
  517. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/pages.py +0 -0
  518. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/layout/report.py +0 -0
  519. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/objects/tracked.py +0 -0
  520. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/opc/relationships.py +0 -0
  521. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/body.py +0 -0
  522. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/canonical_defaults.py +0 -0
  523. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/color.py +0 -0
  524. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/common.py +0 -0
  525. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/document.py +0 -0
  526. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/header_compat.py +0 -0
  527. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/history_part.py +0 -0
  528. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/master_page.py +0 -0
  529. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/parser.py +0 -0
  530. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/schema.py +0 -0
  531. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/settings.py +0 -0
  532. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/oxml/version_part.py +0 -0
  533. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/package.py +0 -0
  534. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/__init__.py +0 -0
  535. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_execute.py +0 -0
  536. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_model.py +0 -0
  537. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_schema.py +0 -0
  538. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/plan/_validate.py +0 -0
  539. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/py.typed +0 -0
  540. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/ledger.py +0 -0
  541. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/rendering.py +0 -0
  542. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/quality/report.py +0 -0
  543. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/templates.py +0 -0
  544. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/header.xsd +0 -0
  545. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-body.xsd +0 -0
  546. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-core.xsd +0 -0
  547. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-header.xsd +0 -0
  548. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-paralist.xsd +0 -0
  549. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/owpml-xml.xsd +0 -0
  550. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/_schemas/section.xsd +0 -0
  551. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/id_integrity.py +0 -0
  552. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/idempotence.py +0 -0
  553. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/object_finder.py +0 -0
  554. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/package_reconcile.py +0 -0
  555. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/read_fidelity.py +0 -0
  556. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/recover.py +0 -0
  557. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/roundtrip_diff.py +0 -0
  558. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/hwpx/tools/toc_fidelity.py +0 -0
  559. {python_hwpx-6.12.0 → python_hwpx-7.0.0}/src/python_hwpx.egg-info/dependency_links.txt +0 -0
  560. {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: 6.12.0
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 :: 4 - Beta
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
- Requires-Dist: latex2mathml>=3.77; extra == "preview"
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.save_to_path("계획.hwpx")
98
+ doc.save("계획.hwpx")
99
99
  ```
100
100
 
101
101
  스타일은 이름으로 고릅니다. 없는 이름을 쓰면 그 줄에서 바로 오류가 납니다.
102
102
  있는 문서를 고칠 때는 `HwpxDocument.open("보고서.hwpx")`로 시작합니다. `.hwp`도 똑같이 열고,
103
- `save_to_path("보고서.hwp")`로 HWP 5.0으로 저장할 수 있습니다.
103
+ 고친 결과는 `save("보고서.hwpx")`로 HWPX로 저장합니다.
104
104
 
105
- 문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
106
- [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)을 함께 설치하세요.
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
- - 읽기·추출: 텍스트·HTML·Markdown으로 내보냅니다. 서식과 표 안의 표를 살립니다. 각주·미주는 `notes=True`를 주거나
114
- `markdown(rich=True)`·`TextExtractor`를 쓸 때 나오고, 머리말·꼬리말·메모는 `TextExtractor`에서만 나옵니다.
115
- 수식·글자 겹침·양식 개체 캡션은 아직 어느 경로에서도 나오지 않습니다. Markdown 변환(`hwpx.ingest`)은 빠진
116
- 종류와 개수를 `warnings`와 `lossiness`로 알립니다.
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
- - 양식 채우기: 라벨로 칸을 찾아 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
142
+ - 양식 채우기: 칸·누름틀에 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
119
143
  칸에 들어가도록 줄을 바꾸거나 글자를 줄일지 한/글의 글자 폭으로 재서 고릅니다.
120
144
  - 표 구조 편집: 행·열 넣기와 지우기, 칸 나누기와 합치기. `doc.tables[0]`처럼 번호로 표를 꺼냅니다.
121
- - 만들기·일괄 처리: 새 문서, 목차·상호 참조, 메일 머지, 문서 비교, 변경 추적.
122
- - HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고 `.hwp`로 저장합니다. 옮기지 못한 내용은
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, 저장 전 열림 검사, 저장 결과 보고(`return_report=True`). 기본 저장은 없는 글자 모양·
128
- 문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `save_report(quality=QualityPolicy.strict())`가 합니다
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
- values = {
138
- "성명 > right": "홍길동",
139
- "소속 > right": "플랫폼팀",
140
- }
141
- result = doc.tables.fill_by_path(values)
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
- 라벨이 겹치거나 없으면 실패로 돌려주고 저장하기 전에 멈출 수 있습니다. `mode="patch"`는 고치지 않은
148
- ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽과 화면 배치는 따로 확인해야 합니다. 저장한 파일을
149
- 다시 열어 내용까지 확인하는 방법은 [안전한 쓰기 계약](docs/safe-write-contract.md)에 있습니다.
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
- **배치: python-hwpx 6.9 이후 main · 2026-10-25**
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
- 개발 단계는 Beta입니다. 하위 호환을 지키는 범위는 [안정 API 표면](docs/stable-api.md)에 적혀 있고,
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`, `.hwp` (HWP 5.0) 읽기·쓰기 | `.hwpx` | `.hwp` (v5 바이너리) |
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()`·`add_control()`은 저수준 탈출구라, 그대로 저장하면 한/글이 열지 못하는 파일이 됩니다(부를 때
235
- 경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는 `add_line()`·`add_rectangle()`·`add_ellipse()`·
236
- `add_arc()`·`add_polygon()`·`add_curve()`·`add_connector()`·`add_container()`(묶음)를, 컨트롤은
237
- `add_column_definition()`·`add_bookmark()`·`add_hyperlink()`를 쓰세요.
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.save_to_path("계획.hwpx")
39
+ doc.save("계획.hwpx")
40
40
  ```
41
41
 
42
42
  스타일은 이름으로 고릅니다. 없는 이름을 쓰면 그 줄에서 바로 오류가 납니다.
43
43
  있는 문서를 고칠 때는 `HwpxDocument.open("보고서.hwpx")`로 시작합니다. `.hwp`도 똑같이 열고,
44
- `save_to_path("보고서.hwp")`로 HWP 5.0으로 저장할 수 있습니다.
44
+ 고친 결과는 `save("보고서.hwpx")`로 HWPX로 저장합니다.
45
45
 
46
- 문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
47
- [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)을 함께 설치하세요.
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
- - 읽기·추출: 텍스트·HTML·Markdown으로 내보냅니다. 서식과 표 안의 표를 살립니다. 각주·미주는 `notes=True`를 주거나
55
- `markdown(rich=True)`·`TextExtractor`를 쓸 때 나오고, 머리말·꼬리말·메모는 `TextExtractor`에서만 나옵니다.
56
- 수식·글자 겹침·양식 개체 캡션은 아직 어느 경로에서도 나오지 않습니다. Markdown 변환(`hwpx.ingest`)은 빠진
57
- 종류와 개수를 `warnings`와 `lossiness`로 알립니다.
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
- - 양식 채우기: 라벨로 칸을 찾아 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
83
+ - 양식 채우기: 칸·누름틀에 값만 넣고 손대지 않은 부분은 바이트 그대로 둡니다. FormFit은 값이
60
84
  칸에 들어가도록 줄을 바꾸거나 글자를 줄일지 한/글의 글자 폭으로 재서 고릅니다.
61
85
  - 표 구조 편집: 행·열 넣기와 지우기, 칸 나누기와 합치기. `doc.tables[0]`처럼 번호로 표를 꺼냅니다.
62
- - 만들기·일괄 처리: 새 문서, 목차·상호 참조, 메일 머지, 문서 비교, 변경 추적.
63
- - HWP 5.0: `.hwp`를 HWPX로 읽어 같은 API로 고치고 `.hwp`로 저장합니다. 옮기지 못한 내용은
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, 저장 전 열림 검사, 저장 결과 보고(`return_report=True`). 기본 저장은 없는 글자 모양·
69
- 문단 모양을 가리키는 참조까지는 확인하지 않습니다. 그 검사는 `save_report(quality=QualityPolicy.strict())`가 합니다
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
- values = {
79
- "성명 > right": "홍길동",
80
- "소속 > right": "플랫폼팀",
81
- }
82
- result = doc.tables.fill_by_path(values)
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
- 라벨이 겹치거나 없으면 실패로 돌려주고 저장하기 전에 멈출 수 있습니다. `mode="patch"`는 고치지 않은
89
- ZIP 파트를 바이트 그대로 두라는 뜻입니다. 고친 파트 안쪽과 화면 배치는 따로 확인해야 합니다. 저장한 파일을
90
- 다시 열어 내용까지 확인하는 방법은 [안전한 쓰기 계약](docs/safe-write-contract.md)에 있습니다.
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
- **배치: python-hwpx 6.9 이후 main · 2026-10-25**
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
- 개발 단계는 Beta입니다. 하위 호환을 지키는 범위는 [안정 API 표면](docs/stable-api.md)에 적혀 있고,
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`, `.hwp` (HWP 5.0) 읽기·쓰기 | `.hwpx` | `.hwp` (v5 바이너리) |
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()`·`add_control()`은 저수준 탈출구라, 그대로 저장하면 한/글이 열지 못하는 파일이 됩니다(부를 때
176
- 경고만 나옵니다). 도형은 한/글이 요구하는 하위 요소까지 만드는 `add_line()`·`add_rectangle()`·`add_ellipse()`·
177
- `add_arc()`·`add_polygon()`·`add_curve()`·`add_connector()`·`add_container()`(묶음)를, 컨트롤은
178
- `add_column_definition()`·`add_bookmark()`·`add_hyperlink()`를 쓰세요.
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)