python-hwpx 6.12.0__tar.gz → 7.0.1__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 (565) hide show
  1. python_hwpx-7.0.1/MANIFEST.in +8 -0
  2. python_hwpx-7.0.1/PKG-INFO +336 -0
  3. python_hwpx-7.0.1/README.md +277 -0
  4. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/pyproject.toml +60 -35
  5. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/__init__.py +114 -65
  6. python_hwpx-7.0.1/src/hwpx/_document/_legacy.py +84 -0
  7. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/_resolve.py +115 -24
  8. python_hwpx-7.0.1/src/hwpx/_document/_units.py +42 -0
  9. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/fields.py +881 -51
  10. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/headings.py +5 -13
  11. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/highlight.py +64 -5
  12. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/layout.py +311 -222
  13. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/media.py +254 -81
  14. python_hwpx-7.0.1/src/hwpx/_document/memos.py +520 -0
  15. python_hwpx-7.0.1/src/hwpx/_document/ns/_base.py +111 -0
  16. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/ns/fields.py +170 -20
  17. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/ns/media.py +32 -15
  18. python_hwpx-7.0.1/src/hwpx/_document/ns/notes.py +289 -0
  19. python_hwpx-7.0.1/src/hwpx/_document/ns/page.py +1292 -0
  20. python_hwpx-7.0.1/src/hwpx/_document/ns/parts.py +552 -0
  21. python_hwpx-7.0.1/src/hwpx/_document/ns/refs.py +190 -0
  22. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/ns/shapes.py +198 -122
  23. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/ns/styles.py +536 -175
  24. python_hwpx-7.0.1/src/hwpx/_document/ns/tables.py +172 -0
  25. python_hwpx-7.0.1/src/hwpx/_document/ns/text.py +627 -0
  26. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/ns/tracking.py +67 -16
  27. python_hwpx-7.0.1/src/hwpx/_document/persistence.py +870 -0
  28. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/shapes.py +183 -119
  29. python_hwpx-7.0.1/src/hwpx/_document/text_blocks.py +911 -0
  30. python_hwpx-7.0.1/src/hwpx/_document/tracked.py +699 -0
  31. python_hwpx-7.0.1/src/hwpx/_moved_modules.py +324 -0
  32. python_hwpx-7.0.1/src/hwpx/_removed_names.py +1235 -0
  33. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/capabilities.py +67 -80
  34. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/data/contract_docs/known-traps.md +29 -12
  35. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/data/contract_docs/mutation-semantics.md +14 -11
  36. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/data/contract_docs/recipes-traversal.md +8 -8
  37. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/data/contract_docs/support-matrix.md +28 -28
  38. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/document.py +431 -266
  39. python_hwpx-7.0.1/src/hwpx/equation/__init__.py +47 -0
  40. python_hwpx-7.0.1/src/hwpx/equation/authoring.py +807 -0
  41. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/equation/eqedit.py +163 -15
  42. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/equation/measure.py +208 -42
  43. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/equation/tokens.py +84 -0
  44. python_hwpx-7.0.1/src/hwpx/errors.py +782 -0
  45. python_hwpx-7.0.1/src/hwpx/experimental.py +76 -0
  46. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/__init__.py +7 -1
  47. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/measure.py +4 -2
  48. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/cfb.py +37 -0
  49. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/docinfo.py +8 -6
  50. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/docinfo_writer.py +12 -7
  51. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/header_xml.py +75 -18
  52. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/owpml.py +7 -0
  53. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/package.py +79 -9
  54. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/reader.py +3 -5
  55. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/records.py +19 -5
  56. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/section_writer.py +21 -0
  57. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/section_xml.py +170 -30
  58. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/shape_xml.py +2 -2
  59. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/layout/_page_measure.py +10 -3
  60. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/layout/lint.py +5 -5
  61. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/model.py +7 -1
  62. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/mutation_report.py +123 -14
  63. python_hwpx-7.0.1/src/hwpx/objects/__init__.py +275 -0
  64. python_hwpx-7.0.1/src/hwpx/objects/binary_item.py +34 -0
  65. python_hwpx-7.0.1/src/hwpx/objects/checkbox.py +392 -0
  66. python_hwpx-7.0.1/src/hwpx/objects/form_field.py +1117 -0
  67. python_hwpx-7.0.1/src/hwpx/objects/highlight.py +283 -0
  68. python_hwpx-7.0.1/src/hwpx/objects/results.py +1182 -0
  69. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/opc/package.py +925 -142
  70. python_hwpx-7.0.1/src/hwpx/opc/security.py +502 -0
  71. python_hwpx-7.0.1/src/hwpx/opc/xml_utils.py +354 -0
  72. python_hwpx-7.0.1/src/hwpx/opc/zip_records.py +262 -0
  73. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/__init__.py +5 -2
  74. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/_document_impl.py +1 -1
  75. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/_document_primitives.py +424 -99
  76. python_hwpx-7.0.1/src/hwpx/oxml/_line_caches.py +494 -0
  77. python_hwpx-7.0.1/src/hwpx/oxml/_paragraph_text_edit.py +1470 -0
  78. python_hwpx-7.0.1/src/hwpx/oxml/caret.py +169 -0
  79. python_hwpx-7.0.1/src/hwpx/oxml/container.py +1218 -0
  80. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/curves.py +71 -13
  81. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/document_metadata.py +52 -4
  82. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/document_parts.py +243 -134
  83. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/drop_cap.py +7 -5
  84. python_hwpx-7.0.1/src/hwpx/oxml/dutmal_compose.py +372 -0
  85. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/field_marks.py +181 -18
  86. python_hwpx-7.0.1/src/hwpx/oxml/formatting.py +1640 -0
  87. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/header.py +90 -24
  88. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/header_fonts.py +180 -33
  89. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/header_part.py +278 -99
  90. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/hyperlink_form.py +117 -1
  91. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/master_page_authoring.py +79 -4
  92. python_hwpx-7.0.1/src/hwpx/oxml/memo.py +1172 -0
  93. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/namespaces.py +41 -0
  94. python_hwpx-7.0.1/src/hwpx/oxml/note_authoring.py +606 -0
  95. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/numbering.py +2 -13
  96. python_hwpx-7.0.1/src/hwpx/oxml/numbering_kinds.py +569 -0
  97. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/objects.py +568 -204
  98. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/paragraph.py +588 -207
  99. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/paragraph_heading.py +50 -0
  100. python_hwpx-7.0.1/src/hwpx/oxml/run.py +1484 -0
  101. python_hwpx-7.0.1/src/hwpx/oxml/section.py +1233 -0
  102. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/section_format.py +311 -215
  103. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/section_layout.py +4 -2
  104. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/section_story.py +216 -67
  105. python_hwpx-7.0.1/src/hwpx/oxml/shape_position.py +3139 -0
  106. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/simple_parts.py +86 -0
  107. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/table.py +210 -144
  108. python_hwpx-7.0.1/src/hwpx/oxml/table_format.py +1048 -0
  109. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/table_merge.py +64 -1
  110. python_hwpx-7.0.1/src/hwpx/oxml/table_rows.py +280 -0
  111. python_hwpx-7.0.1/src/hwpx/oxml/table_sizes.py +1044 -0
  112. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/table_structure.py +135 -16
  113. python_hwpx-7.0.1/src/hwpx/oxml/text_offsets.py +104 -0
  114. python_hwpx-7.0.1/src/hwpx/oxml/text_ranges.py +1506 -0
  115. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/utils.py +39 -2
  116. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/patch.py +268 -207
  117. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/quality/__init__.py +4 -4
  118. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/quality/policy.py +1 -1
  119. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/quality/save_pipeline.py +155 -28
  120. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/table_patch.py +20 -9
  121. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/__init__.py +15 -91
  122. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/archive_cli.py +76 -0
  123. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/doc_diff.py +20 -125
  124. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/document_merge.py +601 -77
  125. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/exporter.py +194 -181
  126. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/generic_inventory.py +2 -0
  127. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/ir_equality.py +9 -2
  128. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/package_validator.py +122 -31
  129. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/page_guard.py +11 -1
  130. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/redline.py +15 -5
  131. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/repair.py +70 -1
  132. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/table_navigation.py +14 -274
  133. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/template_analyzer.py +7 -2
  134. python_hwpx-7.0.1/src/hwpx/tools/text_extract_cli.py +135 -0
  135. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/text_extractor.py +27 -7
  136. python_hwpx-7.0.1/src/hwpx/tools/toc_author.py +921 -0
  137. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/validator.py +51 -11
  138. python_hwpx-7.0.1/src/python_hwpx.egg-info/PKG-INFO +336 -0
  139. python_hwpx-7.0.1/src/python_hwpx.egg-info/SOURCES.txt +209 -0
  140. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/python_hwpx.egg-info/entry_points.txt +0 -1
  141. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/python_hwpx.egg-info/requires.txt +4 -4
  142. python_hwpx-6.12.0/PKG-INFO +0 -269
  143. python_hwpx-6.12.0/README.md +0 -210
  144. python_hwpx-6.12.0/src/hwpx/_document/_legacy.py +0 -1762
  145. python_hwpx-6.12.0/src/hwpx/_document/_units.py +0 -16
  146. python_hwpx-6.12.0/src/hwpx/_document/memos.py +0 -328
  147. python_hwpx-6.12.0/src/hwpx/_document/ns/_base.py +0 -40
  148. python_hwpx-6.12.0/src/hwpx/_document/ns/notes.py +0 -210
  149. python_hwpx-6.12.0/src/hwpx/_document/ns/page.py +0 -615
  150. python_hwpx-6.12.0/src/hwpx/_document/ns/parts.py +0 -374
  151. python_hwpx-6.12.0/src/hwpx/_document/ns/refs.py +0 -86
  152. python_hwpx-6.12.0/src/hwpx/_document/ns/tables.py +0 -132
  153. python_hwpx-6.12.0/src/hwpx/_document/ns/text.py +0 -391
  154. python_hwpx-6.12.0/src/hwpx/_document/persistence.py +0 -545
  155. python_hwpx-6.12.0/src/hwpx/_document/text_blocks.py +0 -385
  156. python_hwpx-6.12.0/src/hwpx/_document/tracked.py +0 -290
  157. python_hwpx-6.12.0/src/hwpx/_moved_modules.py +0 -118
  158. python_hwpx-6.12.0/src/hwpx/equation/__init__.py +0 -54
  159. python_hwpx-6.12.0/src/hwpx/equation/authoring.py +0 -475
  160. python_hwpx-6.12.0/src/hwpx/equation/mathml.py +0 -157
  161. python_hwpx-6.12.0/src/hwpx/equation/render.py +0 -83
  162. python_hwpx-6.12.0/src/hwpx/errors.py +0 -454
  163. python_hwpx-6.12.0/src/hwpx/experimental.py +0 -84
  164. python_hwpx-6.12.0/src/hwpx/ingest/__init__.py +0 -26
  165. python_hwpx-6.12.0/src/hwpx/ingest/base.py +0 -236
  166. python_hwpx-6.12.0/src/hwpx/ingest/hwpx_converter.py +0 -290
  167. python_hwpx-6.12.0/src/hwpx/objects/__init__.py +0 -73
  168. python_hwpx-6.12.0/src/hwpx/objects/binary_item.py +0 -58
  169. python_hwpx-6.12.0/src/hwpx/objects/checkbox.py +0 -103
  170. python_hwpx-6.12.0/src/hwpx/objects/form_field.py +0 -348
  171. python_hwpx-6.12.0/src/hwpx/objects/highlight.py +0 -41
  172. python_hwpx-6.12.0/src/hwpx/objects/results.py +0 -373
  173. python_hwpx-6.12.0/src/hwpx/opc/security.py +0 -240
  174. python_hwpx-6.12.0/src/hwpx/opc/xml_utils.py +0 -165
  175. python_hwpx-6.12.0/src/hwpx/oxml/_paragraph_text_edit.py +0 -188
  176. python_hwpx-6.12.0/src/hwpx/oxml/container.py +0 -377
  177. python_hwpx-6.12.0/src/hwpx/oxml/dutmal_compose.py +0 -134
  178. python_hwpx-6.12.0/src/hwpx/oxml/memo.py +0 -567
  179. python_hwpx-6.12.0/src/hwpx/oxml/note_authoring.py +0 -194
  180. python_hwpx-6.12.0/src/hwpx/oxml/numbering_kinds.py +0 -178
  181. python_hwpx-6.12.0/src/hwpx/oxml/run.py +0 -668
  182. python_hwpx-6.12.0/src/hwpx/oxml/section.py +0 -870
  183. python_hwpx-6.12.0/src/hwpx/oxml/shape_position.py +0 -600
  184. python_hwpx-6.12.0/src/hwpx/oxml/table_sizes.py +0 -538
  185. python_hwpx-6.12.0/src/hwpx/tools/document_viewer.py +0 -182
  186. python_hwpx-6.12.0/src/hwpx/tools/format_rules.py +0 -530
  187. python_hwpx-6.12.0/src/hwpx/tools/layout_preview.py +0 -752
  188. python_hwpx-6.12.0/src/hwpx/tools/mail_merge.py +0 -518
  189. python_hwpx-6.12.0/src/hwpx/tools/markdown_export.py +0 -647
  190. python_hwpx-6.12.0/src/hwpx/tools/markdown_import.py +0 -473
  191. python_hwpx-6.12.0/src/hwpx/tools/report_utils.py +0 -132
  192. python_hwpx-6.12.0/src/hwpx/tools/table_cleanup.py +0 -61
  193. python_hwpx-6.12.0/src/hwpx/tools/text_extract_cli.py +0 -67
  194. python_hwpx-6.12.0/src/hwpx/tools/toc_author.py +0 -475
  195. python_hwpx-6.12.0/src/python_hwpx.egg-info/PKG-INFO +0 -269
  196. python_hwpx-6.12.0/src/python_hwpx.egg-info/SOURCES.txt +0 -511
  197. python_hwpx-6.12.0/tests/test_add_control.py +0 -83
  198. python_hwpx-6.12.0/tests/test_add_heading.py +0 -355
  199. python_hwpx-6.12.0/tests/test_adoption_metrics_snapshot.py +0 -90
  200. python_hwpx-6.12.0/tests/test_append_paragraph_cost.py +0 -61
  201. python_hwpx-6.12.0/tests/test_arc_authoring.py +0 -294
  202. python_hwpx-6.12.0/tests/test_authoring_defaults.py +0 -412
  203. python_hwpx-6.12.0/tests/test_authoring_quality_corpus.py +0 -514
  204. python_hwpx-6.12.0/tests/test_blind_eval_fixture.py +0 -155
  205. python_hwpx-6.12.0/tests/test_body_patch.py +0 -190
  206. python_hwpx-6.12.0/tests/test_body_patch_color_runs.py +0 -197
  207. python_hwpx-6.12.0/tests/test_body_patch_ops.py +0 -461
  208. python_hwpx-6.12.0/tests/test_border_fill_image_gradient.py +0 -361
  209. python_hwpx-6.12.0/tests/test_border_line_types.py +0 -72
  210. python_hwpx-6.12.0/tests/test_build_element_census.py +0 -186
  211. python_hwpx-6.12.0/tests/test_byte_patch_identity.py +0 -314
  212. python_hwpx-6.12.0/tests/test_capabilities_surface.py +0 -198
  213. python_hwpx-6.12.0/tests/test_cell_border_neighbors.py +0 -135
  214. python_hwpx-6.12.0/tests/test_cell_edit_holder_cache.py +0 -101
  215. python_hwpx-6.12.0/tests/test_cell_fields.py +0 -224
  216. python_hwpx-6.12.0/tests/test_cell_line_spacing.py +0 -177
  217. python_hwpx-6.12.0/tests/test_cell_margins.py +0 -311
  218. python_hwpx-6.12.0/tests/test_cell_text_rewrite_semantics.py +0 -145
  219. python_hwpx-6.12.0/tests/test_char_pr_child_order.py +0 -64
  220. python_hwpx-6.12.0/tests/test_character_width_ratio.py +0 -35
  221. python_hwpx-6.12.0/tests/test_chart_authoring.py +0 -313
  222. python_hwpx-6.12.0/tests/test_check_box_authoring.py +0 -154
  223. python_hwpx-6.12.0/tests/test_color_arguments.py +0 -170
  224. python_hwpx-6.12.0/tests/test_column_break.py +0 -109
  225. python_hwpx-6.12.0/tests/test_column_widths_as_shares.py +0 -119
  226. python_hwpx-6.12.0/tests/test_comment_node_robustness.py +0 -85
  227. python_hwpx-6.12.0/tests/test_container_authoring.py +0 -352
  228. python_hwpx-6.12.0/tests/test_container_members.py +0 -216
  229. python_hwpx-6.12.0/tests/test_contract_docs_sync.py +0 -41
  230. python_hwpx-6.12.0/tests/test_corpus_read_fidelity.py +0 -38
  231. python_hwpx-6.12.0/tests/test_coverage_ledger.py +0 -1104
  232. python_hwpx-6.12.0/tests/test_coverage_promotion.py +0 -671
  233. python_hwpx-6.12.0/tests/test_coverage_targets.py +0 -74
  234. python_hwpx-6.12.0/tests/test_curve_connector_authoring.py +0 -179
  235. python_hwpx-6.12.0/tests/test_dev_extra_matches_ci.py +0 -41
  236. python_hwpx-6.12.0/tests/test_deviations_registry.py +0 -454
  237. python_hwpx-6.12.0/tests/test_distribution_file_sizes.py +0 -89
  238. python_hwpx-6.12.0/tests/test_doc_diff.py +0 -71
  239. python_hwpx-6.12.0/tests/test_document_context_manager.py +0 -65
  240. python_hwpx-6.12.0/tests/test_document_facade_surface.py +0 -87
  241. python_hwpx-6.12.0/tests/test_document_formatting.py +0 -1995
  242. python_hwpx-6.12.0/tests/test_document_merge.py +0 -1318
  243. python_hwpx-6.12.0/tests/test_document_metadata.py +0 -144
  244. python_hwpx-6.12.0/tests/test_document_ops_runtime_boundary.py +0 -256
  245. python_hwpx-6.12.0/tests/test_document_save_api.py +0 -319
  246. python_hwpx-6.12.0/tests/test_document_viewer.py +0 -136
  247. python_hwpx-6.12.0/tests/test_documentation_code_fences.py +0 -531
  248. python_hwpx-6.12.0/tests/test_drop_cap_authoring.py +0 -258
  249. python_hwpx-6.12.0/tests/test_dutmal_compose_authoring.py +0 -238
  250. python_hwpx-6.12.0/tests/test_edit_clears_line_cache.py +0 -199
  251. python_hwpx-6.12.0/tests/test_edit_fidelity_corpus.py +0 -311
  252. python_hwpx-6.12.0/tests/test_edit_plan.py +0 -356
  253. python_hwpx-6.12.0/tests/test_editor_surface_inventory.py +0 -119
  254. python_hwpx-6.12.0/tests/test_engine_small_defects_eng36.py +0 -110
  255. python_hwpx-6.12.0/tests/test_engine_surface_6_0.py +0 -501
  256. python_hwpx-6.12.0/tests/test_ensure_run_font_by_lang.py +0 -248
  257. python_hwpx-6.12.0/tests/test_equalize_widths_per_row.py +0 -297
  258. python_hwpx-6.12.0/tests/test_equation_authoring.py +0 -417
  259. python_hwpx-6.12.0/tests/test_equation_converter.py +0 -301
  260. python_hwpx-6.12.0/tests/test_equation_font_boundaries.py +0 -93
  261. python_hwpx-6.12.0/tests/test_equation_measure_hancom_saved.py +0 -99
  262. python_hwpx-6.12.0/tests/test_equation_render.py +0 -184
  263. python_hwpx-6.12.0/tests/test_equation_size.py +0 -109
  264. python_hwpx-6.12.0/tests/test_equation_width_hancom_boxes.py +0 -73
  265. python_hwpx-6.12.0/tests/test_error_contract.py +0 -235
  266. python_hwpx-6.12.0/tests/test_error_messages.py +0 -143
  267. python_hwpx-6.12.0/tests/test_evalplan_core_primitives.py +0 -71
  268. python_hwpx-6.12.0/tests/test_existing_document_format_editing.py +0 -203
  269. python_hwpx-6.12.0/tests/test_export_captions_dutmal.py +0 -162
  270. python_hwpx-6.12.0/tests/test_export_cell_text_spaces.py +0 -29
  271. python_hwpx-6.12.0/tests/test_export_list_labels.py +0 -194
  272. python_hwpx-6.12.0/tests/test_export_notes.py +0 -202
  273. python_hwpx-6.12.0/tests/test_export_text_boxes.py +0 -157
  274. python_hwpx-6.12.0/tests/test_exporter_table_text.py +0 -164
  275. python_hwpx-6.12.0/tests/test_field_marks.py +0 -328
  276. python_hwpx-6.12.0/tests/test_field_readers.py +0 -158
  277. python_hwpx-6.12.0/tests/test_field_type_ids.py +0 -120
  278. python_hwpx-6.12.0/tests/test_fill_image_hancom_modes.py +0 -73
  279. python_hwpx-6.12.0/tests/test_form_field_authoring.py +0 -221
  280. python_hwpx-6.12.0/tests/test_form_field_fill_cost.py +0 -66
  281. python_hwpx-6.12.0/tests/test_form_fields.py +0 -372
  282. python_hwpx-6.12.0/tests/test_form_fill_core_primitives.py +0 -38
  283. python_hwpx-6.12.0/tests/test_form_fit.py +0 -587
  284. python_hwpx-6.12.0/tests/test_form_fit_hancom_rules.py +0 -2100
  285. python_hwpx-6.12.0/tests/test_form_fit_integration.py +0 -200
  286. python_hwpx-6.12.0/tests/test_format_rules.py +0 -233
  287. python_hwpx-6.12.0/tests/test_fuzz_catalog_derive_expected.py +0 -173
  288. python_hwpx-6.12.0/tests/test_fuzz_loop.py +0 -129
  289. python_hwpx-6.12.0/tests/test_fuzz_regressions.py +0 -56
  290. python_hwpx-6.12.0/tests/test_gap_and_new_number_values.py +0 -143
  291. python_hwpx-6.12.0/tests/test_gap_closure_tools.py +0 -788
  292. python_hwpx-6.12.0/tests/test_glyph_table_data.py +0 -58
  293. python_hwpx-6.12.0/tests/test_golden_api.py +0 -305
  294. python_hwpx-6.12.0/tests/test_header_compat_authoring.py +0 -319
  295. python_hwpx-6.12.0/tests/test_header_control_before_field.py +0 -78
  296. python_hwpx-6.12.0/tests/test_header_list_lookups.py +0 -71
  297. python_hwpx-6.12.0/tests/test_header_lookup_cache.py +0 -91
  298. python_hwpx-6.12.0/tests/test_heading_style_shapes.py +0 -58
  299. python_hwpx-6.12.0/tests/test_highlight_authoring.py +0 -289
  300. python_hwpx-6.12.0/tests/test_hp_tab_support.py +0 -64
  301. python_hwpx-6.12.0/tests/test_hwp5_container.py +0 -255
  302. python_hwpx-6.12.0/tests/test_hwp5_hancom_files.py +0 -163
  303. python_hwpx-6.12.0/tests/test_hwp5_open.py +0 -1387
  304. python_hwpx-6.12.0/tests/test_hwp5_open_errors.py +0 -110
  305. python_hwpx-6.12.0/tests/test_hwp5_save.py +0 -1989
  306. python_hwpx-6.12.0/tests/test_hwp5_scripts_limits.py +0 -60
  307. python_hwpx-6.12.0/tests/test_hwpxlib_corpus_read.py +0 -36
  308. python_hwpx-6.12.0/tests/test_hyperlink_hancom_form.py +0 -110
  309. python_hwpx-6.12.0/tests/test_id_generator_range.py +0 -32
  310. python_hwpx-6.12.0/tests/test_id_integrity.py +0 -54
  311. python_hwpx-6.12.0/tests/test_image_object_workflow.py +0 -294
  312. python_hwpx-6.12.0/tests/test_index_mark.py +0 -158
  313. python_hwpx-6.12.0/tests/test_ingest.py +0 -124
  314. python_hwpx-6.12.0/tests/test_inline_models.py +0 -113
  315. python_hwpx-6.12.0/tests/test_insert_column_by_clone.py +0 -200
  316. python_hwpx-6.12.0/tests/test_insert_row_merged_cells.py +0 -130
  317. python_hwpx-6.12.0/tests/test_insert_row_sides.py +0 -193
  318. python_hwpx-6.12.0/tests/test_instid_attribute_case.py +0 -126
  319. python_hwpx-6.12.0/tests/test_integration_hwpx_compatibility.py +0 -228
  320. python_hwpx-6.12.0/tests/test_integration_roundtrip.py +0 -327
  321. python_hwpx-6.12.0/tests/test_internal_calls_skip_moved_names.py +0 -77
  322. python_hwpx-6.12.0/tests/test_known_leak_migration_contract.py +0 -94
  323. python_hwpx-6.12.0/tests/test_layer_leak_guard.py +0 -181
  324. python_hwpx-6.12.0/tests/test_layout_cache_scope.py +0 -293
  325. python_hwpx-6.12.0/tests/test_layout_line_cache.py +0 -991
  326. python_hwpx-6.12.0/tests/test_layout_lint.py +0 -816
  327. python_hwpx-6.12.0/tests/test_layout_page_estimate.py +0 -2995
  328. python_hwpx-6.12.0/tests/test_layout_pages_split.py +0 -64
  329. python_hwpx-6.12.0/tests/test_layout_preview.py +0 -60
  330. python_hwpx-6.12.0/tests/test_lazy_hwp5_import.py +0 -87
  331. python_hwpx-6.12.0/tests/test_lazy_tools_import.py +0 -91
  332. python_hwpx-6.12.0/tests/test_lazy_tools_submodules.py +0 -149
  333. python_hwpx-6.12.0/tests/test_library_boundary_closure.py +0 -195
  334. python_hwpx-6.12.0/tests/test_line_break_writing.py +0 -214
  335. python_hwpx-6.12.0/tests/test_line_width_arguments.py +0 -94
  336. python_hwpx-6.12.0/tests/test_list_continue.py +0 -112
  337. python_hwpx-6.12.0/tests/test_list_defaults_vs_hancom.py +0 -80
  338. python_hwpx-6.12.0/tests/test_list_level_range.py +0 -53
  339. python_hwpx-6.12.0/tests/test_llms_txt.py +0 -124
  340. python_hwpx-6.12.0/tests/test_mail_merge_xlsx.py +0 -38
  341. python_hwpx-6.12.0/tests/test_manifest_resolve_once.py +0 -52
  342. python_hwpx-6.12.0/tests/test_markdown_export.py +0 -436
  343. python_hwpx-6.12.0/tests/test_markdown_export_shape_text.py +0 -75
  344. python_hwpx-6.12.0/tests/test_markdown_import.py +0 -208
  345. python_hwpx-6.12.0/tests/test_master_page_authoring.py +0 -181
  346. python_hwpx-6.12.0/tests/test_master_page_pages_taken.py +0 -181
  347. python_hwpx-6.12.0/tests/test_memo_and_style_editing.py +0 -474
  348. python_hwpx-6.12.0/tests/test_memo_fields.py +0 -124
  349. python_hwpx-6.12.0/tests/test_memo_shape_authoring.py +0 -249
  350. python_hwpx-6.12.0/tests/test_merge_cells_hancom_files.py +0 -46
  351. python_hwpx-6.12.0/tests/test_merge_cells_keeps_contents.py +0 -180
  352. python_hwpx-6.12.0/tests/test_migration_seams.py +0 -116
  353. python_hwpx-6.12.0/tests/test_moved_module_imports.py +0 -105
  354. python_hwpx-6.12.0/tests/test_moved_surface_hints.py +0 -66
  355. python_hwpx-6.12.0/tests/test_mutation_report.py +0 -343
  356. python_hwpx-6.12.0/tests/test_namespace_handling.py +0 -134
  357. python_hwpx-6.12.0/tests/test_namespace_hygiene.py +0 -192
  358. python_hwpx-6.12.0/tests/test_namespace_normalization.py +0 -109
  359. python_hwpx-6.12.0/tests/test_native_edit_contract.py +0 -338
  360. python_hwpx-6.12.0/tests/test_nested_cell_fill_safety.py +0 -301
  361. python_hwpx-6.12.0/tests/test_nested_table_structure_edits.py +0 -259
  362. python_hwpx-6.12.0/tests/test_new_features.py +0 -593
  363. python_hwpx-6.12.0/tests/test_note_authoring_contract.py +0 -121
  364. python_hwpx-6.12.0/tests/test_ns_fields.py +0 -157
  365. python_hwpx-6.12.0/tests/test_ns_media.py +0 -94
  366. python_hwpx-6.12.0/tests/test_ns_notes.py +0 -120
  367. python_hwpx-6.12.0/tests/test_ns_page.py +0 -284
  368. python_hwpx-6.12.0/tests/test_ns_refs.py +0 -77
  369. python_hwpx-6.12.0/tests/test_ns_shapes.py +0 -198
  370. python_hwpx-6.12.0/tests/test_ns_tables.py +0 -130
  371. python_hwpx-6.12.0/tests/test_ns_tracking.py +0 -139
  372. python_hwpx-6.12.0/tests/test_number_formats.py +0 -132
  373. python_hwpx-6.12.0/tests/test_opc_package.py +0 -969
  374. python_hwpx-6.12.0/tests/test_open_damaged_input.py +0 -158
  375. python_hwpx-6.12.0/tests/test_open_safety_corpus.py +0 -88
  376. python_hwpx-6.12.0/tests/test_outline_numbering.py +0 -120
  377. python_hwpx-6.12.0/tests/test_oxml_modularization.py +0 -453
  378. python_hwpx-6.12.0/tests/test_oxml_parsing.py +0 -385
  379. python_hwpx-6.12.0/tests/test_package_hygiene.py +0 -558
  380. python_hwpx-6.12.0/tests/test_package_text_and_namespaces.py +0 -291
  381. python_hwpx-6.12.0/tests/test_packaging_license_metadata.py +0 -63
  382. python_hwpx-6.12.0/tests/test_packaging_py_typed.py +0 -42
  383. python_hwpx-6.12.0/tests/test_page_and_list_values.py +0 -161
  384. python_hwpx-6.12.0/tests/test_page_number_control.py +0 -323
  385. python_hwpx-6.12.0/tests/test_page_number_format.py +0 -73
  386. python_hwpx-6.12.0/tests/test_page_orientation.py +0 -157
  387. python_hwpx-6.12.0/tests/test_para_pr_dedup.py +0 -133
  388. python_hwpx-6.12.0/tests/test_paragraph_align_distribute_space.py +0 -41
  389. python_hwpx-6.12.0/tests/test_paragraph_border.py +0 -168
  390. python_hwpx-6.12.0/tests/test_paragraph_format_targets.py +0 -218
  391. python_hwpx-6.12.0/tests/test_paragraph_hyperlink_style.py +0 -127
  392. python_hwpx-6.12.0/tests/test_paragraph_keep_together.py +0 -46
  393. python_hwpx-6.12.0/tests/test_paragraph_margin_default_scale.py +0 -89
  394. python_hwpx-6.12.0/tests/test_paragraph_matcher.py +0 -126
  395. python_hwpx-6.12.0/tests/test_paragraph_property_lookup.py +0 -82
  396. python_hwpx-6.12.0/tests/test_paragraph_property_version_switch.py +0 -160
  397. python_hwpx-6.12.0/tests/test_paragraph_remove_in_containers.py +0 -133
  398. python_hwpx-6.12.0/tests/test_paragraph_section_management.py +0 -459
  399. python_hwpx-6.12.0/tests/test_part_hierarchy_read_models.py +0 -250
  400. python_hwpx-6.12.0/tests/test_picture_adjustments.py +0 -256
  401. python_hwpx-6.12.0/tests/test_polygon_authoring.py +0 -368
  402. python_hwpx-6.12.0/tests/test_preview_and_markdown_untrusted_values.py +0 -171
  403. python_hwpx-6.12.0/tests/test_product_boundary.py +0 -923
  404. python_hwpx-6.12.0/tests/test_public_artifact_hygiene.py +0 -570
  405. python_hwpx-6.12.0/tests/test_public_exceptions_inherit_hwpx_error.py +0 -48
  406. python_hwpx-6.12.0/tests/test_public_runtime_boundary.py +0 -12
  407. python_hwpx-6.12.0/tests/test_read_fidelity.py +0 -170
  408. python_hwpx-6.12.0/tests/test_recover_broken_zip.py +0 -332
  409. python_hwpx-6.12.0/tests/test_redline_authoring.py +0 -349
  410. python_hwpx-6.12.0/tests/test_redline_verify.py +0 -130
  411. python_hwpx-6.12.0/tests/test_release_checklist_example.py +0 -37
  412. python_hwpx-6.12.0/tests/test_release_workflow_safety.py +0 -1182
  413. python_hwpx-6.12.0/tests/test_remove_unused_charts.py +0 -104
  414. python_hwpx-6.12.0/tests/test_remove_unused_images.py +0 -84
  415. python_hwpx-6.12.0/tests/test_repair_repack.py +0 -347
  416. python_hwpx-6.12.0/tests/test_replace_text_barriers.py +0 -113
  417. python_hwpx-6.12.0/tests/test_report_utils.py +0 -56
  418. python_hwpx-6.12.0/tests/test_repr_snapshots.py +0 -68
  419. python_hwpx-6.12.0/tests/test_return_contract.py +0 -523
  420. python_hwpx-6.12.0/tests/test_roundtrip_fidelity.py +0 -92
  421. python_hwpx-6.12.0/tests/test_roundtrip_fidelity_corpus.py +0 -47
  422. python_hwpx-6.12.0/tests/test_row_heights.py +0 -76
  423. python_hwpx-6.12.0/tests/test_run_choice_atom_authoring.py +0 -174
  424. python_hwpx-6.12.0/tests/test_run_content_kinds.py +0 -117
  425. python_hwpx-6.12.0/tests/test_run_font_refs.py +0 -53
  426. python_hwpx-6.12.0/tests/test_run_style_base.py +0 -100
  427. python_hwpx-6.12.0/tests/test_safe_edit_example.py +0 -129
  428. python_hwpx-6.12.0/tests/test_save_keeps_inline_text_caches.py +0 -78
  429. python_hwpx-6.12.0/tests/test_save_pipeline.py +0 -322
  430. python_hwpx-6.12.0/tests/test_save_verifies_once.py +0 -62
  431. python_hwpx-6.12.0/tests/test_save_with_comment_nodes.py +0 -122
  432. python_hwpx-6.12.0/tests/test_section_clear_body.py +0 -611
  433. python_hwpx-6.12.0/tests/test_section_columns.py +0 -247
  434. python_hwpx-6.12.0/tests/test_section_headers.py +0 -383
  435. python_hwpx-6.12.0/tests/test_section_ids_order.py +0 -136
  436. python_hwpx-6.12.0/tests/test_section_properties_real_roundtrip.py +0 -101
  437. python_hwpx-6.12.0/tests/test_set_column_widths_uniform_split.py +0 -65
  438. python_hwpx-6.12.0/tests/test_set_paragraph_format_keep.py +0 -73
  439. python_hwpx-6.12.0/tests/test_shape_geometry_contract.py +0 -353
  440. python_hwpx-6.12.0/tests/test_shape_open_safety_risk_check.py +0 -213
  441. python_hwpx-6.12.0/tests/test_shape_original_size.py +0 -167
  442. python_hwpx-6.12.0/tests/test_shape_position_frames.py +0 -355
  443. python_hwpx-6.12.0/tests/test_shape_size_values.py +0 -212
  444. python_hwpx-6.12.0/tests/test_size_ratchet.py +0 -102
  445. python_hwpx-6.12.0/tests/test_skeleton_template_ids.py +0 -25
  446. python_hwpx-6.12.0/tests/test_split_cell.py +0 -229
  447. python_hwpx-6.12.0/tests/test_split_merged_cell.py +0 -188
  448. python_hwpx-6.12.0/tests/test_stable_surface.py +0 -357
  449. python_hwpx-6.12.0/tests/test_stale_layout_cache_sweep.py +0 -197
  450. python_hwpx-6.12.0/tests/test_story_edits_reach_control_copy.py +0 -256
  451. python_hwpx-6.12.0/tests/test_style_font_border_reads.py +0 -830
  452. python_hwpx-6.12.0/tests/test_style_resolution.py +0 -348
  453. python_hwpx-6.12.0/tests/test_styles_definition_verbs.py +0 -98
  454. python_hwpx-6.12.0/tests/test_tab_character_writing.py +0 -107
  455. python_hwpx-6.12.0/tests/test_tab_definition_version_switch.py +0 -230
  456. python_hwpx-6.12.0/tests/test_table_cell_equalize.py +0 -93
  457. python_hwpx-6.12.0/tests/test_table_cleanup.py +0 -49
  458. python_hwpx-6.12.0/tests/test_table_clone_identities.py +0 -210
  459. python_hwpx-6.12.0/tests/test_table_column_floor.py +0 -119
  460. python_hwpx-6.12.0/tests/test_table_grid_cache.py +0 -127
  461. python_hwpx-6.12.0/tests/test_table_label.py +0 -150
  462. python_hwpx-6.12.0/tests/test_table_navigation.py +0 -242
  463. python_hwpx-6.12.0/tests/test_table_ops_cells_without_geometry.py +0 -61
  464. python_hwpx-6.12.0/tests/test_table_ops_delete_every_line.py +0 -44
  465. python_hwpx-6.12.0/tests/test_table_ops_delete_zones.py +0 -74
  466. python_hwpx-6.12.0/tests/test_table_page_flow.py +0 -57
  467. python_hwpx-6.12.0/tests/test_table_patch.py +0 -602
  468. python_hwpx-6.12.0/tests/test_table_patch_dryrun.py +0 -64
  469. python_hwpx-6.12.0/tests/test_table_patch_m105.py +0 -271
  470. python_hwpx-6.12.0/tests/test_table_patch_structure_fixes.py +0 -224
  471. python_hwpx-6.12.0/tests/test_table_split_merge.py +0 -258
  472. python_hwpx-6.12.0/tests/test_table_structure_edits.py +0 -416
  473. python_hwpx-6.12.0/tests/test_tables_default_border.py +0 -81
  474. python_hwpx-6.12.0/tests/test_template_analyzer_enrichment.py +0 -97
  475. python_hwpx-6.12.0/tests/test_text_blocks.py +0 -223
  476. python_hwpx-6.12.0/tests/test_text_box_fields.py +0 -87
  477. python_hwpx-6.12.0/tests/test_text_extractor_annotations.py +0 -126
  478. python_hwpx-6.12.0/tests/test_text_extractor_nested_once.py +0 -107
  479. python_hwpx-6.12.0/tests/test_text_extractor_run_choice_atoms.py +0 -160
  480. python_hwpx-6.12.0/tests/test_text_inline_elements.py +0 -180
  481. python_hwpx-6.12.0/tests/test_text_replace_everywhere.py +0 -211
  482. python_hwpx-6.12.0/tests/test_title_mark.py +0 -133
  483. python_hwpx-6.12.0/tests/test_toc_author.py +0 -304
  484. python_hwpx-6.12.0/tests/test_toc_fidelity.py +0 -250
  485. python_hwpx-6.12.0/tests/test_tools_untrusted_xml.py +0 -74
  486. python_hwpx-6.12.0/tests/test_tracked_overlap_render_smoke.py +0 -112
  487. python_hwpx-6.12.0/tests/test_tracked_paragraph_delete_break.py +0 -47
  488. python_hwpx-6.12.0/tests/test_trailing_table_text.py +0 -153
  489. python_hwpx-6.12.0/tests/test_validation_severity.py +0 -52
  490. python_hwpx-6.12.0/tests/test_validator_comment_nodes.py +0 -56
  491. python_hwpx-6.12.0/tests/test_validator_form_parameters.py +0 -96
  492. python_hwpx-6.12.0/tests/test_validator_full_schema.py +0 -152
  493. python_hwpx-6.12.0/tests/test_validator_hancom_open_rules.py +0 -313
  494. python_hwpx-6.12.0/tests/test_validator_section_ids.py +0 -141
  495. python_hwpx-6.12.0/tests/test_version_metadata.py +0 -34
  496. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/LICENSE +0 -0
  497. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/NOTICE +0 -0
  498. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/setup.cfg +0 -0
  499. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/__init__.py +0 -0
  500. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_document/ns/__init__.py +0 -0
  501. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/_trailing_table_text.py +0 -0
  502. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/body_patch.py +0 -0
  503. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/data/Skeleton.hwpx +0 -0
  504. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/_glyph_table.json.gz +0 -0
  505. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/_glyph_table.py +0 -0
  506. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/apply.py +0 -0
  507. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/engine.py +0 -0
  508. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/policy.py +0 -0
  509. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/form_fit/report.py +0 -0
  510. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/__init__.py +0 -0
  511. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/binary.py +0 -0
  512. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/bodytext.py +0 -0
  513. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/controls.py +0 -0
  514. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/errors.py +0 -0
  515. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/fileheader.py +0 -0
  516. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/section_common.py +0 -0
  517. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/shapes.py +0 -0
  518. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/summary.py +0 -0
  519. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/hwp5/writer.py +0 -0
  520. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/layout/__init__.py +0 -0
  521. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/layout/line_cache.py +0 -0
  522. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/layout/pages.py +0 -0
  523. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/layout/report.py +0 -0
  524. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/objects/tracked.py +0 -0
  525. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/opc/relationships.py +0 -0
  526. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/body.py +0 -0
  527. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/canonical_defaults.py +0 -0
  528. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/color.py +0 -0
  529. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/common.py +0 -0
  530. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/document.py +0 -0
  531. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/header_compat.py +0 -0
  532. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/history_part.py +0 -0
  533. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/master_page.py +0 -0
  534. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/parser.py +0 -0
  535. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/schema.py +0 -0
  536. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/settings.py +0 -0
  537. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/oxml/version_part.py +0 -0
  538. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/package.py +0 -0
  539. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/plan/__init__.py +0 -0
  540. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/plan/_execute.py +0 -0
  541. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/plan/_model.py +0 -0
  542. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/plan/_schema.py +0 -0
  543. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/plan/_validate.py +0 -0
  544. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/py.typed +0 -0
  545. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/quality/ledger.py +0 -0
  546. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/quality/rendering.py +0 -0
  547. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/quality/report.py +0 -0
  548. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/templates.py +0 -0
  549. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/_schemas/header.xsd +0 -0
  550. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/_schemas/owpml-body.xsd +0 -0
  551. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/_schemas/owpml-core.xsd +0 -0
  552. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/_schemas/owpml-header.xsd +0 -0
  553. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/_schemas/owpml-paralist.xsd +0 -0
  554. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/_schemas/owpml-xml.xsd +0 -0
  555. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/_schemas/section.xsd +0 -0
  556. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/id_integrity.py +0 -0
  557. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/idempotence.py +0 -0
  558. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/object_finder.py +0 -0
  559. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/package_reconcile.py +0 -0
  560. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/read_fidelity.py +0 -0
  561. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/recover.py +0 -0
  562. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/roundtrip_diff.py +0 -0
  563. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/hwpx/tools/toc_fidelity.py +0 -0
  564. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/src/python_hwpx.egg-info/dependency_links.txt +0 -0
  565. {python_hwpx-6.12.0 → python_hwpx-7.0.1}/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
@@ -0,0 +1,336 @@
1
+ Metadata-Version: 2.4
2
+ Name: python-hwpx
3
+ Version: 7.0.1
4
+ Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리
5
+ Author: python-hwpx Maintainers
6
+ License-Expression: Apache-2.0
7
+ Project-URL: Homepage, https://github.com/airmang/python-hwpx
8
+ Project-URL: Documentation, https://airmang.github.io/python-hwpx/
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
12
+ Keywords: hwp,hwpx,hancom,opc,xml,document-automation,validation,template
13
+ Classifier: Development Status :: 5 - Production/Stable
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Programming Language :: Python :: 3.13
20
+ Classifier: Programming Language :: Python :: 3.14
21
+ Classifier: Topic :: Software Development :: Libraries
22
+ Classifier: Topic :: Text Processing :: Markup :: XML
23
+ Classifier: Typing :: Typed
24
+ Requires-Python: >=3.10
25
+ Description-Content-Type: text/markdown
26
+ License-File: LICENSE
27
+ License-File: NOTICE
28
+ Requires-Dist: lxml<7,>=4.9
29
+ Provides-Extra: visual
30
+ Provides-Extra: xlsx
31
+ Provides-Extra: preview
32
+ Provides-Extra: langchain
33
+ Provides-Extra: llamaindex
34
+ Provides-Extra: dev
35
+ Requires-Dist: build>=1.0; extra == "dev"
36
+ Requires-Dist: twine>=4.0; extra == "dev"
37
+ Requires-Dist: numpy>=1.26; extra == "dev"
38
+ Requires-Dist: pillow>=10.0; extra == "dev"
39
+ Requires-Dist: pytest>=7.4; extra == "dev"
40
+ Requires-Dist: pytest-cov>=5.0; extra == "dev"
41
+ Requires-Dist: pyyaml<7,>=6.0; extra == "dev"
42
+ Requires-Dist: ruff>=0.12; extra == "dev"
43
+ Requires-Dist: latex2mathml>=3.77; extra == "dev"
44
+ Requires-Dist: mypy>=1.10; extra == "dev"
45
+ Requires-Dist: pyright>=1.1.390; extra == "dev"
46
+ Provides-Extra: test
47
+ Requires-Dist: build>=1.0; extra == "test"
48
+ Requires-Dist: numpy>=1.26; extra == "test"
49
+ Requires-Dist: pillow>=10.0; extra == "test"
50
+ Requires-Dist: pytest>=7.4; extra == "test"
51
+ Requires-Dist: pytest-cov>=5.0; extra == "test"
52
+ Requires-Dist: pyyaml<7,>=6.0; extra == "test"
53
+ Requires-Dist: ruff>=0.12; extra == "test"
54
+ Requires-Dist: latex2mathml>=3.77; extra == "test"
55
+ Provides-Extra: typecheck
56
+ Requires-Dist: mypy>=1.10; extra == "typecheck"
57
+ Requires-Dist: pyright>=1.1.390; extra == "typecheck"
58
+ Dynamic: license-file
59
+
60
+ <p align="center">
61
+ <h1 align="center">python-hwpx</h1>
62
+ <p align="center">
63
+ <strong>한컴오피스 없이 한/글 문서(HWPX·HWP)를 읽고, 고치고, 만드는 파이썬 엔진</strong>
64
+ </p>
65
+ <p align="center">
66
+ <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/v/python-hwpx?color=blue&label=PyPI" alt="PyPI"></a>
67
+ <a href="https://pepy.tech/project/python-hwpx"><img src="https://static.pepy.tech/badge/python-hwpx/month" alt="Downloads"></a>
68
+ <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/pyversions/python-hwpx" alt="Python"></a>
69
+ <a href="https://github.com/airmang/python-hwpx/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/airmang/python-hwpx/tests.yml?branch=main&label=tests" alt="Tests"></a>
70
+ <a href="https://github.com/airmang/python-hwpx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License"></a>
71
+ </p>
72
+ <p align="center">
73
+ 한국어 | <a href="https://github.com/airmang/python-hwpx/blob/main/README_EN.md">English</a>
74
+ · <a href="https://github.com/airmang/python-hwpx/blob/main/docs/quickstart.md">퀵스타트</a>
75
+ · <a href="https://github.com/airmang/python-hwpx/blob/main/docs/usage.md">사용 가이드</a>
76
+ · <a href="https://airmang.github.io/python-hwpx/">API 레퍼런스</a>
77
+ · <a href="https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md">7.0 이주 가이드</a>
78
+ </p>
79
+ </p>
80
+
81
+ python-docx가 `.docx`를 다루듯, python-hwpx는 한/글 문서를 다룹니다. HWPX는 XML(OWPML)을 ZIP으로 묶은 형식이라
82
+ 한컴오피스 없이도 읽고 쓸 수 있습니다. Windows·macOS·Linux는 물론 CI에서도 돌아가고, 필요한 패키지는 `lxml` 하나뿐입니다.
83
+ HWP 5.0(`.hwp`) 파일도 같은 API로 열어 HWPX로 저장할 수 있습니다.
84
+
85
+ <p align="center">
86
+ <img src="https://raw.githubusercontent.com/airmang/python-hwpx/main/docs/assets/hancom-7.0-report.png" width="640" alt="정부 보고서 서식으로 만든 2026년 디지털 교육 운영 계획을 한컴오피스가 그린 쪽. 색 띠 제목, 남색 칸의 장 번호, □와 - 위계, 위아래 굵은 선의 표가 있다">
87
+ </p>
88
+ <p align="center"><sub>python-hwpx 7.0.0 위에서 python-hwpx-automation 8.0의 보고서 서식(<code>from_markdown(md, style="report")</code>)으로 만든 문서를 한컴오피스 12.30.0이 그린 쪽(PDF로 내보낸 것).</sub></p>
89
+
90
+ > **7.0이 나왔습니다.** 저장 함수와 공개 이름이 바뀌었고, 일부 기능은 다른 패키지로 옮겼습니다.
91
+ > 6.x를 쓰고 있었다면 [7.0에서 무엇이 왜 바뀌었나](#70에서-무엇이-왜-바뀌었나)부터 읽어 주세요.
92
+
93
+ ## 설치
94
+
95
+ ```bash
96
+ pip install -U python-hwpx # Python 3.10+
97
+ ```
98
+
99
+ ## 빠른 시작
100
+
101
+ 새 문서를 만들어 봅니다. 스타일은 이름으로 지정하며, 문서에 없는 이름을 쓰면 그 자리에서 오류가 납니다.
102
+
103
+ <!-- standalone-python-example -->
104
+
105
+ ```python
106
+ from hwpx import HwpxDocument
107
+
108
+ doc = HwpxDocument.new()
109
+ doc.add_heading("2026 운영계획", level=1)
110
+ doc.add_paragraph("추진 배경", style="개요 2") # 한/글이 "가." 번호를 붙인다
111
+ doc.save("계획.hwpx")
112
+ ```
113
+
114
+ 글자 크기와 정렬, 표 칸은 바로 읽고 고칠 수 있습니다. 표 칸·머리말·각주에 든 문단까지 위치와 함께 차례로 훑을 수도 있습니다.
115
+
116
+ <!-- standalone-python-example -->
117
+
118
+ ```python
119
+ from hwpx import HwpxDocument
120
+
121
+ doc = HwpxDocument.new()
122
+ title = doc.add_paragraph("2026 운영계획")
123
+ title.alignment = "CENTER"
124
+ title.runs[-1].size = 16
125
+ table = doc.add_table(2, 2)
126
+ table.cell(0, 0).text = "기간"
127
+ table.cell(0, 1).text = "3월 ~ 7월"
128
+ for place in doc.text.iter_paragraphs(where={"cell"}):
129
+ print(place.row, place.col, place.paragraph.text)
130
+ doc.save("계획.hwpx")
131
+ ```
132
+
133
+ ### 양식 채우기
134
+
135
+ 기존 문서는 `HwpxDocument.open("보고서.hwpx")`로 엽니다. `.hwp` 파일도 똑같이 열리며, 고친 결과는 HWPX로 저장됩니다.
136
+ 양식에 값만 채우고 나머지는 원본 그대로 두고 싶다면 `mode="patch"`로 저장하세요.
137
+
138
+ ```python
139
+ doc = HwpxDocument.open("신청서.hwpx")
140
+ for cell in doc.tables.map()["tables"][0]["cells"]: # 표의 칸마다 행·열과 글
141
+ print(cell["row"], cell["col"], cell["text"]) # 0 0 성 명 / 0 1 (빈 칸) ...
142
+ doc.tables[0].cell(0, 1).text = "홍길동"
143
+ doc.tables[0].cell(1, 1).text = "플랫폼팀"
144
+ report = doc.save("신청서-작성완료.hwpx", mode="patch", fallback="error")
145
+ ```
146
+
147
+ <p align="center">
148
+ <img src="https://raw.githubusercontent.com/airmang/python-hwpx/main/docs/assets/hancom-7.0-form-fill.png" width="760" alt="빈 방과후학교 참가 신청서와, python-hwpx가 칸에 값만 채운 같은 신청서를 한컴오피스가 그린 쪽">
149
+ </p>
150
+ <p align="center"><sub>빈 양식(왼쪽)과 <code>mode="patch"</code>로 값만 채운 양식(오른쪽). 둘 다 한컴오피스가 그린 쪽입니다.</sub></p>
151
+
152
+ `mode="patch"`로 저장하면 손대지 않은 부분은 압축된 바이트까지 원본과 같습니다. 아무것도 고치지 않았다면 파일 전체가
153
+ 원본과 똑같습니다. 무엇이 바뀌었는지는 `save()`가 돌려주는 보고서(`MutationReport`)에서 확인할 수 있습니다.
154
+
155
+ 칸 안에 표가 들어 있는 양식이라면 주의할 점이 하나 있습니다. `doc.tables.map()`의 표 번호(`table_index`)는 안쪽 표까지 센
156
+ 번호이므로, 표를 고를 때는 `doc.tables.with_nested[table_index]`를 쓰세요. 이름표 글자로 칸을 찾아 채우는 기능은
157
+ [python-hwpx-automation](#함께-쓰는-패키지)에 있습니다.
158
+
159
+ <sub>앞의 두 예제는 그대로 실행됩니다. 세 번째처럼 내 문서가 있어야 돌아가는 조각까지, 예제마다의 Python 블록 판정은
160
+ [실행 기록](https://github.com/airmang/python-hwpx/blob/main/docs/python-example-ledger.json)에 남겨 둡니다.</sub>
161
+
162
+ ## 할 수 있는 것
163
+
164
+ | | |
165
+ |---|---|
166
+ | **읽기** | 한/글의 "텍스트로 저장"과 같은 평문(`doc.text.plain()`), 정해진 글자 수 안의 개요(`doc.text.outline()`), 표 칸·글상자·머리말·각주 속 문단과 그 위치(`doc.text.iter_paragraphs()`) |
167
+ | **편집** | 문단과 런, 글자·문단 서식, 머리말·꼬리말, 쪽 설정과 쪽 번호, 그림, 도형, 수식, 메모, 각주·미주 |
168
+ | **표** | 칸 읽고 쓰기, 행·열 넣기·지우기·옮기기, 칸 합치기·나누기, 테두리와 채우기, 칸 안의 표 |
169
+ | **양식** | 누름틀 읽고 채우기, 값만 넣는 패치 저장, 값이 칸에 들어가도록 줄을 바꾸거나 글자를 줄이는 FormFit |
170
+ | **문서 구조** | 차례, 상호 참조, 책갈피, 하이퍼링크, 변경 추적, 문서끼리 복사·병합 |
171
+ | **HWP 5.0** | `.hwp`를 같은 API로 읽어 HWPX로 저장. 옮기지 못한 내용은 `doc.conversion_report`에 기록. `.hwp`로 다시 쓰기는 실험 기능 |
172
+ | **검사** | 패키지 구조 검사, 저장 전 한/글 열림 검사, 저장 품질 정책(`QualityPolicy`) |
173
+ | **배치 추정** (실험) | 한/글 없이 쪽 수와 줄 위치 추정(`estimate_pages`), 확실한 문단에만 줄 배치 정보 쓰기(`write_line_caches`) |
174
+
175
+ 개발 단계는 안정(Production/Stable)입니다. 하위 호환을 약속하는 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)에
176
+ 정리해 두었습니다. `hwpx.experimental`과 위 표에서 "실험"으로 표시한 기능은 바뀔 수 있습니다.
177
+
178
+ ## 7.0에서 무엇이 왜 바뀌었나
179
+
180
+ 7.0에서 지킨 원칙은 하나입니다. **엔진은 파일에 적힌 것과 다른 값을 돌려주지 않고, 한/글이 받아들이지 않을 파일을 쓰지
181
+ 않습니다.** 같은 파일에는 언제나 같은 결과를 내고, 한/글에서 확인한 근거가 없는 쓰기는 하지 않습니다. 아래 여섯 가지 변경은
182
+ 모두 이 원칙에서 나왔습니다.
183
+
184
+ ### 1. 짐작이 필요한 기능은 python-hwpx-automation으로 옮겼습니다
185
+
186
+ **바뀐 것:** Markdown·HTML 변환, 다른 형식 가져오기, LangChain·LlamaIndex 연동, 이름표로 양식 칸 찾기, 메일 머지, 미리보기,
187
+ 서식 규칙 검사를 [python-hwpx-automation](https://github.com/airmang/python-hwpx-automation) 8.0으로 옮겼습니다.
188
+
189
+ **왜:** 이런 기능에는 정답이 하나로 정해져 있지 않습니다. 이름표 옆 칸이 정말 그 항목을 적는 칸인지, Markdown 제목을 어떤
190
+ 모양으로 옮길지는 결국 짐작이나 취향의 문제입니다. 엔진 안에 짐작이 섞이면 "파일에 적힌 그대로"라는 약속을 기계로 검증할 수
191
+ 없게 됩니다. 그래서 파일에 적힌 것을 읽고 쓰는 일은 엔진에, 짐작하고 고르는 일은 자동화 패키지에 두었습니다.
192
+
193
+ 기능이 사라진 것은 아닙니다. 인자와 결과는 6.x와 같고, 옛 이름을 부르면 새 위치를 알려 주는 오류가 납니다. 엔진이 의존하는
194
+ 패키지는 여전히 `lxml` 하나입니다.
195
+
196
+ ### 2. 저장은 `doc.save()` 하나로 합쳤습니다
197
+
198
+ **바뀐 것:** `save_to_path`·`save_to_stream`·`save_report`를 `doc.save(target)` 하나로, `from_package`를 `open()`으로 합쳤습니다.
199
+ `save()`는 경로와 스트림을 모두 받고, 언제나 `MutationReport`를 돌려줍니다.
200
+
201
+ **왜:** 네 함수는 하는 일이 겹치는데도 돌려주는 값이 `None`, 경로, 보고서로 제각각이었습니다. 저장 결과를 확인하려면 어떤
202
+ 함수를 써야 하는지부터 기억해야 했습니다. 이제는 어떻게 저장하든 결과가 같은 형태로 돌아오고, 스트림에 저장하다 실패하면
203
+ 쓰기 전 상태로 되돌립니다.
204
+
205
+ ### 3. 공개 이름을 한 가지 규칙으로 정리하고 고정했습니다
206
+
207
+ **바뀐 것:** `row_index=` → `row=`, `horz_rel_to=` → `horizontal_relative_to=`, `line_width='33'` → `line_width_mm=0.12`,
208
+ `table.get_cell_map()` → `table.cell_map`처럼 이름을 고쳤습니다. 6.0에서 경고와 함께 남겨 두었던 루트의 옛 이름 79개도 지웠습니다.
209
+
210
+ **왜:** 6.x에는 줄임말, XML 속성 이름을 그대로 옮긴 이름, 단위 없는 숫자, `get_` 접두사가 뒤섞여 있어 이름을 하나하나 외워야
211
+ 했습니다. `'33'`만 봐서는 무슨 단위인지 알 수 없는 식입니다. 이제 규칙은 세 가지입니다. 이름은 줄이지 않고 풀어 쓰고, 단위는
212
+ 이름에 붙이고, 인자가 없는 읽기는 속성으로 둡니다.
213
+
214
+ 이번이 마지막 이름 변경입니다. 공개 이름은 `tests/data/public_surface.json`에 고정해 두었고, 다음 major 판까지 바꾸지 않습니다.
215
+ 한꺼번에 정리하면서 6.x에서 미리 경고하지 않았던 이름(저장 함수 등)도 함께 지웠는데, 이는
216
+ [안정 API 규칙](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)의 예외입니다. 그 대신 지운 이름을 부르면
217
+ 새 이름과 한 줄짜리 예시를 바로 알려 줍니다.
218
+
219
+ ### 4. 한/글이 받아들이지 않을 쓰기는 거부합니다
220
+
221
+ **바뀐 것:** 엔진이 새로 쓰는 XML은 모두 한/글이 실제로 저장한 파일을 근거로 삼습니다. 근거가 없는 조합은 쓰기 전에 `code`가
222
+ 붙은 오류로 거부하며, 거부된 호출은 문서를 전혀 바꾸지 않습니다. 문서에서 떼어 낸 표나 문단을 통해 문서를 고치려 해도 거부하고,
223
+ 읽기만 해서 문서가 바뀌는 일도 없습니다. `.hwp`로 쓰기는 실험 기능으로 두되, 원본을 덮어쓰거나 옮기지 못한 내용이 있는 경우에는
224
+ 쓰지 않습니다.
225
+
226
+ **왜:** 가장 나쁜 실패는 오류 없이 저장됐는데 한/글에서 열리지 않거나 다르게 보이는 파일입니다. 틀린 파일을 조용히 만드느니,
227
+ 분명하게 거부하고 이유를 알려 주는 편이 낫습니다.
228
+
229
+ ### 5. XML을 직접 고쳐야 했던 일을 공개 API로 열었습니다
230
+
231
+ **바뀐 것:** 표 구조 편집, 개체의 위치·회전·뒤집기, 글자·문단 서식, 누름틀, 각주·미주, 차례, 상호 참조, 변경 추적을 공개 API로
232
+ 다룰 수 있습니다.
233
+
234
+ **왜:** 6.x에서는 이런 작업을 하려면 `.element`로 XML을 직접 고쳐야 했고, 그렇게 고친 내용은 엔진의 검사를 거치지 않았습니다.
235
+ 공개 API를 쓰면 4번의 거부와 검사가 함께 적용됩니다. 본체 코드가 6.12.0보다 약 2만 1천 줄(23%) 늘어난 것도 대부분 이
236
+ 때문입니다. `.element`는 탈출구로 남겨 두었지만 호환을 약속하는 표면은 아닙니다.
237
+
238
+ ### 6. 새 문서가 빈 줄로 시작하지 않습니다
239
+
240
+ **바뀐 것:** `HwpxDocument.new()`로 만든 문서에 처음 더한 문단이 `doc.paragraphs[0]`이 됩니다.
241
+
242
+ **왜:** 6.x에서는 새 문서가 늘 빈 줄로 시작해서, 완성한 문서 맨 위에 쓸모없는 빈 줄이 남았습니다. 이 변경은 오류 없이 문단
243
+ 번호만 하나씩 당겨지므로 [이주 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md) 맨 앞에 따로
244
+ 적어 두었습니다. 6.x처럼 빈 줄로 시작하려면 `HwpxDocument.new(empty_first_line=True)`를 쓰세요.
245
+
246
+ ### 올리는 법
247
+
248
+ 1. `pip install -U python-hwpx`로 올립니다.
249
+ 2. 테스트를 돌립니다. 지운 이름을 쓰는 곳에서는 오류가 새 이름을 알려 줍니다.
250
+ 3. 오류 없이 결과만 달라지는 경우는 [7.0 이주 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md)의 표로 확인합니다.
251
+ 4. 1번에서 옮긴 기능을 쓰고 있다면 `pip install -U "python-hwpx-automation>=8"`도 설치합니다.
252
+
253
+ 바뀐 내용 전체는 [변경 기록](https://github.com/airmang/python-hwpx/blob/main/CHANGELOG.md)에 있습니다.
254
+
255
+ ## 한/글에서 열리는가
256
+
257
+ python-hwpx로 만든 파일을 실제 한컴오피스에서 열어 보고, 확인한 판과 날짜를 함께 적습니다.
258
+
259
+ - **7.0.0** (2026-11-21, macOS 한컴오피스 12.30.0): 7.0.0 휠로 만든 문서 72개가 모두 열렸습니다. 다른 사람이 만든 실제 문서
260
+ 27종을 고친 54개, 새로 만든 문서, 문서끼리 복사·병합한 결과가 들어 있습니다. Windows용 한/글에서는 아직 확인하지 않았습니다.
261
+ - 이전 판의 전체 코퍼스 측정 결과는 [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)에 있습니다.
262
+
263
+ 이 결과는 한/글이 파일을 문제없이 여는지를 확인한 것이며, 화면이 한/글과 똑같다는 뜻은 아닙니다. 엔진은 쪽 배치를 직접 하지
264
+ 않습니다. 내용이 바뀐 문단은 줄 배치 정보를 지워 두고, 한/글이 파일을 열 때 다시 배치하게 합니다.
265
+
266
+ ## 함께 쓰는 패키지
267
+
268
+ | | 저장소 | 역할 |
269
+ |---|---|---|
270
+ | 📦 | [`python-hwpx`](https://github.com/airmang/python-hwpx) | 한/글 문서를 읽고·고치고·만드는 엔진 (이 저장소) |
271
+ | 🔌 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation) | 변환·양식 채움·메일 머지·미리보기·보고서 서식, `hwpx` CLI, MCP 서버, Claude Code·Codex 플러그인 |
272
+ | 🏫 | [`hwpx-school`](https://github.com/airmang/hwpx-school) | 학교 문서(지필평가 원안지·학습지·수행평가 문제지·보고서)를 학교 서식 그대로 만드는 도구 |
273
+
274
+ Claude Code·Codex에서는 python-hwpx-automation 저장소 주소 하나로 플러그인을 설치합니다. 플러그인이 엔진과 자동화 패키지를
275
+ 검증한 판으로 설치하고 MCP 도구와 작업 안내를 붙입니다([uv](https://docs.astral.sh/uv/)가 필요합니다).
276
+ 에이전트에게 "https://github.com/airmang/python-hwpx-automation 플러그인을 설치해 줘"라고 부탁해도 되고, 직접 설치하려면 아래와 같습니다.
277
+
278
+ ```bash
279
+ claude plugin marketplace add airmang/python-hwpx-automation && claude plugin install hwpx-plugin@hwpx
280
+ codex plugin marketplace add airmang/python-hwpx-automation && codex plugin add hwpx-plugin@hwpx
281
+ ```
282
+
283
+ 파이썬 코드에서 자동화 기능까지 쓰려면 `pip install -U python-hwpx-automation` 하나면 됩니다. 엔진도 함께 설치됩니다.
284
+
285
+ 일반 ChatGPT 대화에서도 쓸 수 있습니다. 채팅 속 파이썬 환경은 PyPI에 접속할 수 없으므로,
286
+ [최신 Release](https://github.com/airmang/python-hwpx/releases/latest)의 `python_hwpx-*.whl` 파일을 문서와 함께 올린 뒤
287
+ "첨부한 whl을 pip로 설치하고, 이 .hwpx를 python-hwpx로 열어서 작업해 줘"라고 요청하면 됩니다. 자세한 지시문은
288
+ [AI 채팅 환경에서 쓰기](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)에 있고, AI 도구가 API를 익히도록 만든
289
+ [llms.txt](https://airmang.github.io/python-hwpx/llms.txt)도 있습니다.
290
+
291
+ > 예전 설치 명령과의 호환을 위해 `pip install "python-hwpx[visual]"`도 그대로 동작합니다. 다만 이 extra는 비어 있어
292
+ > 렌더·PDF 의존성을 설치하지 않습니다. 그 일은 `python-hwpx-automation[oracle]`이 맡습니다.
293
+
294
+
295
+ ## 알려진 제약
296
+
297
+ - 엔진은 쪽 배치를 하지 않습니다. 차례나 상호 참조에 들어가는 쪽 번호는 한/글이 파일을 열 때 채웁니다.
298
+ - 쪽 수 추정과 줄 배치 정보 쓰기는 실험 기능입니다. 처리할 수 없는 요소를 만나면 추정하지 않고 그 이유를 돌려줍니다.
299
+ - `.hwp`로 쓰기는 실험 기능입니다. 암호가 걸린 HWPX와 암호·배포용 HWP는 지원하지 않습니다.
300
+ - `doc.shapes.add_raw()`·`add_control()`이나 `.element`로 직접 고친 XML은 엔진의 검사를 거치지 않습니다. 도형은
301
+ `add_line()`·`add_rectangle()` 같은 `doc.shapes` 함수를 쓰세요.
302
+
303
+ 남은 과제와 알려진 결함은 [이슈](https://github.com/airmang/python-hwpx/issues)에서 확인할 수 있습니다.
304
+
305
+ ## 문서
306
+
307
+ [5분 퀵스타트](https://github.com/airmang/python-hwpx/blob/main/docs/quickstart.md) ·
308
+ [사용 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md) ·
309
+ [예제](https://github.com/airmang/python-hwpx/blob/main/docs/examples.md) ·
310
+ [API 레퍼런스](https://airmang.github.io/python-hwpx/) ·
311
+ [안전한 쓰기 계약](https://github.com/airmang/python-hwpx/blob/main/docs/safe-write-contract.md) ·
312
+ [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md) ·
313
+ [오류 코드](https://github.com/airmang/python-hwpx/blob/main/docs/error-codes.md) ·
314
+ [python-docx와 비교](https://github.com/airmang/python-hwpx/blob/main/docs/comparison-python-docx.md)
315
+
316
+ ## 기여하기
317
+
318
+ [help wanted](https://github.com/airmang/python-hwpx/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) ·
319
+ [로드맵](https://github.com/airmang/python-hwpx/milestones) ·
320
+ [Discussions](https://github.com/airmang/python-hwpx/discussions) ·
321
+ [CONTRIBUTING](https://github.com/airmang/python-hwpx/blob/main/CONTRIBUTING.md)
322
+
323
+ HWPX 내부 구조가 처음이라면 [내부 실전 가이드](https://github.com/airmang/python-hwpx/tree/main/docs/internals)부터 읽어 보세요.
324
+ 패키지 사이의 경계는 [제품 경계 문서](https://github.com/airmang/python-hwpx/blob/main/docs/architecture/product-boundary.md)에 정리해 두었습니다.
325
+
326
+ ## 감사의 말
327
+
328
+ - [OWPML, 개방형 워드프로세서 마크업 언어 (KS X 6101)](https://www.kssn.net/search/stddetail.do?itemNo=K001010119985): HWPX의 바탕이 된 한국 산업 표준
329
+ - [hancom-io/hwpx-owpml-model](https://github.com/hancom-io/hwpx-owpml-model): OWPML 요소 구조 참조 모델
330
+ - [neolord0/hwpxlib](https://github.com/neolord0/hwpxlib): 견본 코퍼스
331
+ - [edwardkim/rhwp](https://github.com/edwardkim/rhwp): 멱등성·검증 게이트 설계에 영감을 주었고, 다른 뷰어와의 호환을 확인할 때 씁니다
332
+ - 범정부오피스: 공문서 편집 워크플로 아이디어
333
+
334
+ ## 라이선스
335
+
336
+ 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)
@@ -0,0 +1,277 @@
1
+ <p align="center">
2
+ <h1 align="center">python-hwpx</h1>
3
+ <p align="center">
4
+ <strong>한컴오피스 없이 한/글 문서(HWPX·HWP)를 읽고, 고치고, 만드는 파이썬 엔진</strong>
5
+ </p>
6
+ <p align="center">
7
+ <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/v/python-hwpx?color=blue&label=PyPI" alt="PyPI"></a>
8
+ <a href="https://pepy.tech/project/python-hwpx"><img src="https://static.pepy.tech/badge/python-hwpx/month" alt="Downloads"></a>
9
+ <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/pyversions/python-hwpx" alt="Python"></a>
10
+ <a href="https://github.com/airmang/python-hwpx/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/airmang/python-hwpx/tests.yml?branch=main&label=tests" alt="Tests"></a>
11
+ <a href="https://github.com/airmang/python-hwpx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License"></a>
12
+ </p>
13
+ <p align="center">
14
+ 한국어 | <a href="https://github.com/airmang/python-hwpx/blob/main/README_EN.md">English</a>
15
+ · <a href="https://github.com/airmang/python-hwpx/blob/main/docs/quickstart.md">퀵스타트</a>
16
+ · <a href="https://github.com/airmang/python-hwpx/blob/main/docs/usage.md">사용 가이드</a>
17
+ · <a href="https://airmang.github.io/python-hwpx/">API 레퍼런스</a>
18
+ · <a href="https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md">7.0 이주 가이드</a>
19
+ </p>
20
+ </p>
21
+
22
+ python-docx가 `.docx`를 다루듯, python-hwpx는 한/글 문서를 다룹니다. HWPX는 XML(OWPML)을 ZIP으로 묶은 형식이라
23
+ 한컴오피스 없이도 읽고 쓸 수 있습니다. Windows·macOS·Linux는 물론 CI에서도 돌아가고, 필요한 패키지는 `lxml` 하나뿐입니다.
24
+ HWP 5.0(`.hwp`) 파일도 같은 API로 열어 HWPX로 저장할 수 있습니다.
25
+
26
+ <p align="center">
27
+ <img src="https://raw.githubusercontent.com/airmang/python-hwpx/main/docs/assets/hancom-7.0-report.png" width="640" alt="정부 보고서 서식으로 만든 2026년 디지털 교육 운영 계획을 한컴오피스가 그린 쪽. 색 띠 제목, 남색 칸의 장 번호, □와 - 위계, 위아래 굵은 선의 표가 있다">
28
+ </p>
29
+ <p align="center"><sub>python-hwpx 7.0.0 위에서 python-hwpx-automation 8.0의 보고서 서식(<code>from_markdown(md, style="report")</code>)으로 만든 문서를 한컴오피스 12.30.0이 그린 쪽(PDF로 내보낸 것).</sub></p>
30
+
31
+ > **7.0이 나왔습니다.** 저장 함수와 공개 이름이 바뀌었고, 일부 기능은 다른 패키지로 옮겼습니다.
32
+ > 6.x를 쓰고 있었다면 [7.0에서 무엇이 왜 바뀌었나](#70에서-무엇이-왜-바뀌었나)부터 읽어 주세요.
33
+
34
+ ## 설치
35
+
36
+ ```bash
37
+ pip install -U python-hwpx # Python 3.10+
38
+ ```
39
+
40
+ ## 빠른 시작
41
+
42
+ 새 문서를 만들어 봅니다. 스타일은 이름으로 지정하며, 문서에 없는 이름을 쓰면 그 자리에서 오류가 납니다.
43
+
44
+ <!-- standalone-python-example -->
45
+
46
+ ```python
47
+ from hwpx import HwpxDocument
48
+
49
+ doc = HwpxDocument.new()
50
+ doc.add_heading("2026 운영계획", level=1)
51
+ doc.add_paragraph("추진 배경", style="개요 2") # 한/글이 "가." 번호를 붙인다
52
+ doc.save("계획.hwpx")
53
+ ```
54
+
55
+ 글자 크기와 정렬, 표 칸은 바로 읽고 고칠 수 있습니다. 표 칸·머리말·각주에 든 문단까지 위치와 함께 차례로 훑을 수도 있습니다.
56
+
57
+ <!-- standalone-python-example -->
58
+
59
+ ```python
60
+ from hwpx import HwpxDocument
61
+
62
+ doc = HwpxDocument.new()
63
+ title = doc.add_paragraph("2026 운영계획")
64
+ title.alignment = "CENTER"
65
+ title.runs[-1].size = 16
66
+ table = doc.add_table(2, 2)
67
+ table.cell(0, 0).text = "기간"
68
+ table.cell(0, 1).text = "3월 ~ 7월"
69
+ for place in doc.text.iter_paragraphs(where={"cell"}):
70
+ print(place.row, place.col, place.paragraph.text)
71
+ doc.save("계획.hwpx")
72
+ ```
73
+
74
+ ### 양식 채우기
75
+
76
+ 기존 문서는 `HwpxDocument.open("보고서.hwpx")`로 엽니다. `.hwp` 파일도 똑같이 열리며, 고친 결과는 HWPX로 저장됩니다.
77
+ 양식에 값만 채우고 나머지는 원본 그대로 두고 싶다면 `mode="patch"`로 저장하세요.
78
+
79
+ ```python
80
+ doc = HwpxDocument.open("신청서.hwpx")
81
+ for cell in doc.tables.map()["tables"][0]["cells"]: # 표의 칸마다 행·열과 글
82
+ print(cell["row"], cell["col"], cell["text"]) # 0 0 성 명 / 0 1 (빈 칸) ...
83
+ doc.tables[0].cell(0, 1).text = "홍길동"
84
+ doc.tables[0].cell(1, 1).text = "플랫폼팀"
85
+ report = doc.save("신청서-작성완료.hwpx", mode="patch", fallback="error")
86
+ ```
87
+
88
+ <p align="center">
89
+ <img src="https://raw.githubusercontent.com/airmang/python-hwpx/main/docs/assets/hancom-7.0-form-fill.png" width="760" alt="빈 방과후학교 참가 신청서와, python-hwpx가 칸에 값만 채운 같은 신청서를 한컴오피스가 그린 쪽">
90
+ </p>
91
+ <p align="center"><sub>빈 양식(왼쪽)과 <code>mode="patch"</code>로 값만 채운 양식(오른쪽). 둘 다 한컴오피스가 그린 쪽입니다.</sub></p>
92
+
93
+ `mode="patch"`로 저장하면 손대지 않은 부분은 압축된 바이트까지 원본과 같습니다. 아무것도 고치지 않았다면 파일 전체가
94
+ 원본과 똑같습니다. 무엇이 바뀌었는지는 `save()`가 돌려주는 보고서(`MutationReport`)에서 확인할 수 있습니다.
95
+
96
+ 칸 안에 표가 들어 있는 양식이라면 주의할 점이 하나 있습니다. `doc.tables.map()`의 표 번호(`table_index`)는 안쪽 표까지 센
97
+ 번호이므로, 표를 고를 때는 `doc.tables.with_nested[table_index]`를 쓰세요. 이름표 글자로 칸을 찾아 채우는 기능은
98
+ [python-hwpx-automation](#함께-쓰는-패키지)에 있습니다.
99
+
100
+ <sub>앞의 두 예제는 그대로 실행됩니다. 세 번째처럼 내 문서가 있어야 돌아가는 조각까지, 예제마다의 Python 블록 판정은
101
+ [실행 기록](https://github.com/airmang/python-hwpx/blob/main/docs/python-example-ledger.json)에 남겨 둡니다.</sub>
102
+
103
+ ## 할 수 있는 것
104
+
105
+ | | |
106
+ |---|---|
107
+ | **읽기** | 한/글의 "텍스트로 저장"과 같은 평문(`doc.text.plain()`), 정해진 글자 수 안의 개요(`doc.text.outline()`), 표 칸·글상자·머리말·각주 속 문단과 그 위치(`doc.text.iter_paragraphs()`) |
108
+ | **편집** | 문단과 런, 글자·문단 서식, 머리말·꼬리말, 쪽 설정과 쪽 번호, 그림, 도형, 수식, 메모, 각주·미주 |
109
+ | **표** | 칸 읽고 쓰기, 행·열 넣기·지우기·옮기기, 칸 합치기·나누기, 테두리와 채우기, 칸 안의 표 |
110
+ | **양식** | 누름틀 읽고 채우기, 값만 넣는 패치 저장, 값이 칸에 들어가도록 줄을 바꾸거나 글자를 줄이는 FormFit |
111
+ | **문서 구조** | 차례, 상호 참조, 책갈피, 하이퍼링크, 변경 추적, 문서끼리 복사·병합 |
112
+ | **HWP 5.0** | `.hwp`를 같은 API로 읽어 HWPX로 저장. 옮기지 못한 내용은 `doc.conversion_report`에 기록. `.hwp`로 다시 쓰기는 실험 기능 |
113
+ | **검사** | 패키지 구조 검사, 저장 전 한/글 열림 검사, 저장 품질 정책(`QualityPolicy`) |
114
+ | **배치 추정** (실험) | 한/글 없이 쪽 수와 줄 위치 추정(`estimate_pages`), 확실한 문단에만 줄 배치 정보 쓰기(`write_line_caches`) |
115
+
116
+ 개발 단계는 안정(Production/Stable)입니다. 하위 호환을 약속하는 범위는 [안정 API 표면](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)에
117
+ 정리해 두었습니다. `hwpx.experimental`과 위 표에서 "실험"으로 표시한 기능은 바뀔 수 있습니다.
118
+
119
+ ## 7.0에서 무엇이 왜 바뀌었나
120
+
121
+ 7.0에서 지킨 원칙은 하나입니다. **엔진은 파일에 적힌 것과 다른 값을 돌려주지 않고, 한/글이 받아들이지 않을 파일을 쓰지
122
+ 않습니다.** 같은 파일에는 언제나 같은 결과를 내고, 한/글에서 확인한 근거가 없는 쓰기는 하지 않습니다. 아래 여섯 가지 변경은
123
+ 모두 이 원칙에서 나왔습니다.
124
+
125
+ ### 1. 짐작이 필요한 기능은 python-hwpx-automation으로 옮겼습니다
126
+
127
+ **바뀐 것:** Markdown·HTML 변환, 다른 형식 가져오기, LangChain·LlamaIndex 연동, 이름표로 양식 칸 찾기, 메일 머지, 미리보기,
128
+ 서식 규칙 검사를 [python-hwpx-automation](https://github.com/airmang/python-hwpx-automation) 8.0으로 옮겼습니다.
129
+
130
+ **왜:** 이런 기능에는 정답이 하나로 정해져 있지 않습니다. 이름표 옆 칸이 정말 그 항목을 적는 칸인지, Markdown 제목을 어떤
131
+ 모양으로 옮길지는 결국 짐작이나 취향의 문제입니다. 엔진 안에 짐작이 섞이면 "파일에 적힌 그대로"라는 약속을 기계로 검증할 수
132
+ 없게 됩니다. 그래서 파일에 적힌 것을 읽고 쓰는 일은 엔진에, 짐작하고 고르는 일은 자동화 패키지에 두었습니다.
133
+
134
+ 기능이 사라진 것은 아닙니다. 인자와 결과는 6.x와 같고, 옛 이름을 부르면 새 위치를 알려 주는 오류가 납니다. 엔진이 의존하는
135
+ 패키지는 여전히 `lxml` 하나입니다.
136
+
137
+ ### 2. 저장은 `doc.save()` 하나로 합쳤습니다
138
+
139
+ **바뀐 것:** `save_to_path`·`save_to_stream`·`save_report`를 `doc.save(target)` 하나로, `from_package`를 `open()`으로 합쳤습니다.
140
+ `save()`는 경로와 스트림을 모두 받고, 언제나 `MutationReport`를 돌려줍니다.
141
+
142
+ **왜:** 네 함수는 하는 일이 겹치는데도 돌려주는 값이 `None`, 경로, 보고서로 제각각이었습니다. 저장 결과를 확인하려면 어떤
143
+ 함수를 써야 하는지부터 기억해야 했습니다. 이제는 어떻게 저장하든 결과가 같은 형태로 돌아오고, 스트림에 저장하다 실패하면
144
+ 쓰기 전 상태로 되돌립니다.
145
+
146
+ ### 3. 공개 이름을 한 가지 규칙으로 정리하고 고정했습니다
147
+
148
+ **바뀐 것:** `row_index=` → `row=`, `horz_rel_to=` → `horizontal_relative_to=`, `line_width='33'` → `line_width_mm=0.12`,
149
+ `table.get_cell_map()` → `table.cell_map`처럼 이름을 고쳤습니다. 6.0에서 경고와 함께 남겨 두었던 루트의 옛 이름 79개도 지웠습니다.
150
+
151
+ **왜:** 6.x에는 줄임말, XML 속성 이름을 그대로 옮긴 이름, 단위 없는 숫자, `get_` 접두사가 뒤섞여 있어 이름을 하나하나 외워야
152
+ 했습니다. `'33'`만 봐서는 무슨 단위인지 알 수 없는 식입니다. 이제 규칙은 세 가지입니다. 이름은 줄이지 않고 풀어 쓰고, 단위는
153
+ 이름에 붙이고, 인자가 없는 읽기는 속성으로 둡니다.
154
+
155
+ 이번이 마지막 이름 변경입니다. 공개 이름은 `tests/data/public_surface.json`에 고정해 두었고, 다음 major 판까지 바꾸지 않습니다.
156
+ 한꺼번에 정리하면서 6.x에서 미리 경고하지 않았던 이름(저장 함수 등)도 함께 지웠는데, 이는
157
+ [안정 API 규칙](https://github.com/airmang/python-hwpx/blob/main/docs/stable-api.md)의 예외입니다. 그 대신 지운 이름을 부르면
158
+ 새 이름과 한 줄짜리 예시를 바로 알려 줍니다.
159
+
160
+ ### 4. 한/글이 받아들이지 않을 쓰기는 거부합니다
161
+
162
+ **바뀐 것:** 엔진이 새로 쓰는 XML은 모두 한/글이 실제로 저장한 파일을 근거로 삼습니다. 근거가 없는 조합은 쓰기 전에 `code`가
163
+ 붙은 오류로 거부하며, 거부된 호출은 문서를 전혀 바꾸지 않습니다. 문서에서 떼어 낸 표나 문단을 통해 문서를 고치려 해도 거부하고,
164
+ 읽기만 해서 문서가 바뀌는 일도 없습니다. `.hwp`로 쓰기는 실험 기능으로 두되, 원본을 덮어쓰거나 옮기지 못한 내용이 있는 경우에는
165
+ 쓰지 않습니다.
166
+
167
+ **왜:** 가장 나쁜 실패는 오류 없이 저장됐는데 한/글에서 열리지 않거나 다르게 보이는 파일입니다. 틀린 파일을 조용히 만드느니,
168
+ 분명하게 거부하고 이유를 알려 주는 편이 낫습니다.
169
+
170
+ ### 5. XML을 직접 고쳐야 했던 일을 공개 API로 열었습니다
171
+
172
+ **바뀐 것:** 표 구조 편집, 개체의 위치·회전·뒤집기, 글자·문단 서식, 누름틀, 각주·미주, 차례, 상호 참조, 변경 추적을 공개 API로
173
+ 다룰 수 있습니다.
174
+
175
+ **왜:** 6.x에서는 이런 작업을 하려면 `.element`로 XML을 직접 고쳐야 했고, 그렇게 고친 내용은 엔진의 검사를 거치지 않았습니다.
176
+ 공개 API를 쓰면 4번의 거부와 검사가 함께 적용됩니다. 본체 코드가 6.12.0보다 약 2만 1천 줄(23%) 늘어난 것도 대부분 이
177
+ 때문입니다. `.element`는 탈출구로 남겨 두었지만 호환을 약속하는 표면은 아닙니다.
178
+
179
+ ### 6. 새 문서가 빈 줄로 시작하지 않습니다
180
+
181
+ **바뀐 것:** `HwpxDocument.new()`로 만든 문서에 처음 더한 문단이 `doc.paragraphs[0]`이 됩니다.
182
+
183
+ **왜:** 6.x에서는 새 문서가 늘 빈 줄로 시작해서, 완성한 문서 맨 위에 쓸모없는 빈 줄이 남았습니다. 이 변경은 오류 없이 문단
184
+ 번호만 하나씩 당겨지므로 [이주 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md) 맨 앞에 따로
185
+ 적어 두었습니다. 6.x처럼 빈 줄로 시작하려면 `HwpxDocument.new(empty_first_line=True)`를 쓰세요.
186
+
187
+ ### 올리는 법
188
+
189
+ 1. `pip install -U python-hwpx`로 올립니다.
190
+ 2. 테스트를 돌립니다. 지운 이름을 쓰는 곳에서는 오류가 새 이름을 알려 줍니다.
191
+ 3. 오류 없이 결과만 달라지는 경우는 [7.0 이주 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/migration-7.0.md)의 표로 확인합니다.
192
+ 4. 1번에서 옮긴 기능을 쓰고 있다면 `pip install -U "python-hwpx-automation>=8"`도 설치합니다.
193
+
194
+ 바뀐 내용 전체는 [변경 기록](https://github.com/airmang/python-hwpx/blob/main/CHANGELOG.md)에 있습니다.
195
+
196
+ ## 한/글에서 열리는가
197
+
198
+ python-hwpx로 만든 파일을 실제 한컴오피스에서 열어 보고, 확인한 판과 날짜를 함께 적습니다.
199
+
200
+ - **7.0.0** (2026-11-21, macOS 한컴오피스 12.30.0): 7.0.0 휠로 만든 문서 72개가 모두 열렸습니다. 다른 사람이 만든 실제 문서
201
+ 27종을 고친 54개, 새로 만든 문서, 문서끼리 복사·병합한 결과가 들어 있습니다. Windows용 한/글에서는 아직 확인하지 않았습니다.
202
+ - 이전 판의 전체 코퍼스 측정 결과는 [실측 코퍼스 메트릭](https://airmang.github.io/python-hwpx/corpus-metrics.html)에 있습니다.
203
+
204
+ 이 결과는 한/글이 파일을 문제없이 여는지를 확인한 것이며, 화면이 한/글과 똑같다는 뜻은 아닙니다. 엔진은 쪽 배치를 직접 하지
205
+ 않습니다. 내용이 바뀐 문단은 줄 배치 정보를 지워 두고, 한/글이 파일을 열 때 다시 배치하게 합니다.
206
+
207
+ ## 함께 쓰는 패키지
208
+
209
+ | | 저장소 | 역할 |
210
+ |---|---|---|
211
+ | 📦 | [`python-hwpx`](https://github.com/airmang/python-hwpx) | 한/글 문서를 읽고·고치고·만드는 엔진 (이 저장소) |
212
+ | 🔌 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation) | 변환·양식 채움·메일 머지·미리보기·보고서 서식, `hwpx` CLI, MCP 서버, Claude Code·Codex 플러그인 |
213
+ | 🏫 | [`hwpx-school`](https://github.com/airmang/hwpx-school) | 학교 문서(지필평가 원안지·학습지·수행평가 문제지·보고서)를 학교 서식 그대로 만드는 도구 |
214
+
215
+ Claude Code·Codex에서는 python-hwpx-automation 저장소 주소 하나로 플러그인을 설치합니다. 플러그인이 엔진과 자동화 패키지를
216
+ 검증한 판으로 설치하고 MCP 도구와 작업 안내를 붙입니다([uv](https://docs.astral.sh/uv/)가 필요합니다).
217
+ 에이전트에게 "https://github.com/airmang/python-hwpx-automation 플러그인을 설치해 줘"라고 부탁해도 되고, 직접 설치하려면 아래와 같습니다.
218
+
219
+ ```bash
220
+ claude plugin marketplace add airmang/python-hwpx-automation && claude plugin install hwpx-plugin@hwpx
221
+ codex plugin marketplace add airmang/python-hwpx-automation && codex plugin add hwpx-plugin@hwpx
222
+ ```
223
+
224
+ 파이썬 코드에서 자동화 기능까지 쓰려면 `pip install -U python-hwpx-automation` 하나면 됩니다. 엔진도 함께 설치됩니다.
225
+
226
+ 일반 ChatGPT 대화에서도 쓸 수 있습니다. 채팅 속 파이썬 환경은 PyPI에 접속할 수 없으므로,
227
+ [최신 Release](https://github.com/airmang/python-hwpx/releases/latest)의 `python_hwpx-*.whl` 파일을 문서와 함께 올린 뒤
228
+ "첨부한 whl을 pip로 설치하고, 이 .hwpx를 python-hwpx로 열어서 작업해 줘"라고 요청하면 됩니다. 자세한 지시문은
229
+ [AI 채팅 환경에서 쓰기](https://github.com/airmang/python-hwpx/blob/main/docs/ai-assistants.md)에 있고, AI 도구가 API를 익히도록 만든
230
+ [llms.txt](https://airmang.github.io/python-hwpx/llms.txt)도 있습니다.
231
+
232
+ > 예전 설치 명령과의 호환을 위해 `pip install "python-hwpx[visual]"`도 그대로 동작합니다. 다만 이 extra는 비어 있어
233
+ > 렌더·PDF 의존성을 설치하지 않습니다. 그 일은 `python-hwpx-automation[oracle]`이 맡습니다.
234
+
235
+
236
+ ## 알려진 제약
237
+
238
+ - 엔진은 쪽 배치를 하지 않습니다. 차례나 상호 참조에 들어가는 쪽 번호는 한/글이 파일을 열 때 채웁니다.
239
+ - 쪽 수 추정과 줄 배치 정보 쓰기는 실험 기능입니다. 처리할 수 없는 요소를 만나면 추정하지 않고 그 이유를 돌려줍니다.
240
+ - `.hwp`로 쓰기는 실험 기능입니다. 암호가 걸린 HWPX와 암호·배포용 HWP는 지원하지 않습니다.
241
+ - `doc.shapes.add_raw()`·`add_control()`이나 `.element`로 직접 고친 XML은 엔진의 검사를 거치지 않습니다. 도형은
242
+ `add_line()`·`add_rectangle()` 같은 `doc.shapes` 함수를 쓰세요.
243
+
244
+ 남은 과제와 알려진 결함은 [이슈](https://github.com/airmang/python-hwpx/issues)에서 확인할 수 있습니다.
245
+
246
+ ## 문서
247
+
248
+ [5분 퀵스타트](https://github.com/airmang/python-hwpx/blob/main/docs/quickstart.md) ·
249
+ [사용 가이드](https://github.com/airmang/python-hwpx/blob/main/docs/usage.md) ·
250
+ [예제](https://github.com/airmang/python-hwpx/blob/main/docs/examples.md) ·
251
+ [API 레퍼런스](https://airmang.github.io/python-hwpx/) ·
252
+ [안전한 쓰기 계약](https://github.com/airmang/python-hwpx/blob/main/docs/safe-write-contract.md) ·
253
+ [지원 매트릭스](https://github.com/airmang/python-hwpx/blob/main/docs/support-matrix.md) ·
254
+ [오류 코드](https://github.com/airmang/python-hwpx/blob/main/docs/error-codes.md) ·
255
+ [python-docx와 비교](https://github.com/airmang/python-hwpx/blob/main/docs/comparison-python-docx.md)
256
+
257
+ ## 기여하기
258
+
259
+ [help wanted](https://github.com/airmang/python-hwpx/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) ·
260
+ [로드맵](https://github.com/airmang/python-hwpx/milestones) ·
261
+ [Discussions](https://github.com/airmang/python-hwpx/discussions) ·
262
+ [CONTRIBUTING](https://github.com/airmang/python-hwpx/blob/main/CONTRIBUTING.md)
263
+
264
+ HWPX 내부 구조가 처음이라면 [내부 실전 가이드](https://github.com/airmang/python-hwpx/tree/main/docs/internals)부터 읽어 보세요.
265
+ 패키지 사이의 경계는 [제품 경계 문서](https://github.com/airmang/python-hwpx/blob/main/docs/architecture/product-boundary.md)에 정리해 두었습니다.
266
+
267
+ ## 감사의 말
268
+
269
+ - [OWPML, 개방형 워드프로세서 마크업 언어 (KS X 6101)](https://www.kssn.net/search/stddetail.do?itemNo=K001010119985): HWPX의 바탕이 된 한국 산업 표준
270
+ - [hancom-io/hwpx-owpml-model](https://github.com/hancom-io/hwpx-owpml-model): OWPML 요소 구조 참조 모델
271
+ - [neolord0/hwpxlib](https://github.com/neolord0/hwpxlib): 견본 코퍼스
272
+ - [edwardkim/rhwp](https://github.com/edwardkim/rhwp): 멱등성·검증 게이트 설계에 영감을 주었고, 다른 뷰어와의 호환을 확인할 때 씁니다
273
+ - 범정부오피스: 공문서 편집 워크플로 아이디어
274
+
275
+ ## 라이선스
276
+
277
+ 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)