python-hwpx 6.11.0__tar.gz → 7.0.0__tar.gz

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