python-hwpx 2.0__tar.gz → 2.2__tar.gz

{python_hwpx-2.0 → python_hwpx-2.2}/LICENSE

@@ -1,32 +1,32 @@
-Non-Commercial License
-
-Copyright (c) 2024 python-hwpx Maintainers
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to use,
-copy, modify, merge, publish, distribute, and sublicense the Software only for
-non-commercial purposes, subject to the following conditions:
-
-1. Non-Commercial Use Only. The Software may be used, copied, modified,
-	merged, published, distributed, and sublicensed only for non-commercial
-	purposes. "Non-Commercial" means use that is not primarily intended for or
-	directed toward commercial advantage, monetary compensation, or any form of
-	direct or indirect commercial exploitation.
-
-2. Attribution. The above copyright notice and this permission notice shall be
-	included in all copies or substantial portions of the Software.
-
-3. No Warranty of Commercial Support. The maintainers are not obligated to
-	provide commercial support, maintenance, or updates.
-
-THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-If you require permissions to use this Software for commercial purposes,
-please contact the copyright holders to negotiate an alternative licensing
-arrangement.
+Non-Commercial License
+
+Copyright (c) 2024 python-hwpx Maintainers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, merge, publish, distribute, and sublicense the Software only for
+non-commercial purposes, subject to the following conditions:
+
+1. Non-Commercial Use Only. The Software may be used, copied, modified,
+	merged, published, distributed, and sublicensed only for non-commercial
+	purposes. "Non-Commercial" means use that is not primarily intended for or
+	directed toward commercial advantage, monetary compensation, or any form of
+	direct or indirect commercial exploitation.
+
+2. Attribution. The above copyright notice and this permission notice shall be
+	included in all copies or substantial portions of the Software.
+
+3. No Warranty of Commercial Support. The maintainers are not obligated to
+	provide commercial support, maintenance, or updates.
+
+THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+If you require permissions to use this Software for commercial purposes,
+please contact the copyright holders to negotiate an alternative licensing
+arrangement.

python_hwpx-2.2/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: python-hwpx
+Version: 2.2
+Summary: Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음
+Author: python-hwpx Maintainers
+License: Non-Commercial License
+        
+        Copyright (c) 2024 python-hwpx Maintainers
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to use,
+        copy, modify, merge, publish, distribute, and sublicense the Software only for
+        non-commercial purposes, subject to the following conditions:
+        
+        1. Non-Commercial Use Only. The Software may be used, copied, modified,
+        	merged, published, distributed, and sublicensed only for non-commercial
+        	purposes. "Non-Commercial" means use that is not primarily intended for or
+        	directed toward commercial advantage, monetary compensation, or any form of
+        	direct or indirect commercial exploitation.
+        
+        2. Attribution. The above copyright notice and this permission notice shall be
+        	included in all copies or substantial portions of the Software.
+        
+        3. No Warranty of Commercial Support. The maintainers are not obligated to
+        	provide commercial support, maintenance, or updates.
+        
+        THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+        If you require permissions to use this Software for commercial purposes,
+        please contact the copyright holders to negotiate an alternative licensing
+        arrangement.
+        
+Project-URL: Homepage, https://github.com/airmang/python-hwpx
+Project-URL: Documentation, https://github.com/airmang/python-hwpx/tree/main/docs
+Project-URL: Issues, https://github.com/airmang/python-hwpx/issues
+Keywords: hwp,hwpx,hancom,opc,xml
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Text Processing :: Markup :: XML
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lxml<6,>=4.9
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Requires-Dist: pytest>=7.4; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.4; extra == "test"
+Requires-Dist: pytest-cov>=5.0; extra == "test"
+Provides-Extra: typecheck
+Requires-Dist: mypy>=1.10; extra == "typecheck"
+Requires-Dist: pyright>=1.1.390; extra == "typecheck"
+Dynamic: license-file
+
+<p align="center">
+  <h1 align="center">python-hwpx</h1>
+  <p align="center">
+    <strong>HWPX 문서를 Python으로 읽고, 편집하고, 생성합니다.</strong>
+  </p>
+  <p align="center">
+    <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>
+    <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/pyversions/python-hwpx" alt="Python"></a>
+    <a href="https://github.com/airmang/python-hwpx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Non--Commercial-green" alt="License"></a>
+    <a href="https://airmang.github.io/python-hwpx/"><img src="https://img.shields.io/badge/docs-Sphinx-8CA1AF" alt="Docs"></a>
+  </p>
+</p>
+
+---
+
+`python-hwpx`는 한컴오피스의 [HWPX 포맷](https://www.hancom.com/)을 순수 Python으로 다루는 라이브러리입니다.
+한/글 설치 없이, OS에 관계없이 HWPX 문서의 구조를 파싱하고 콘텐츠를 조작할 수 있습니다.
+
+> **pyhwpx / pyhwp와 다른 점?**
+> `pyhwpx`는 Windows COM 자동화 기반이라 한/글이 설치된 Windows에서만 동작합니다.
+> `pyhwp`는 레거시 `.hwp`(v5 바이너리) 전용입니다.
+> `python-hwpx`는 OWPML/OPC 기반 `.hwpx`를 직접 파싱하므로 **Linux, macOS, CI 환경 어디서든** 동작합니다.
+
+## 설치
+
+```bash
+pip install python-hwpx
+```
+
+> 유일한 의존성은 `lxml`입니다.
+
+## Quick Start
+
+```python
+from hwpx.document import HwpxDocument
+
+# 기존 문서 열기
+doc = HwpxDocument.open("보고서.hwpx")
+
+# 빈 문서 새로 만들기
+doc = HwpxDocument.new()
+
+# 문단 추가
+doc.add_paragraph("python-hwpx로 생성한 문단입니다.")
+
+# 표 추가 (2×3)
+table = doc.add_table(rows=2, cols=3)
+table.set_cell_text(0, 0, "이름")
+table.set_cell_text(0, 1, "부서")
+table.set_cell_text(0, 2, "연락처")
+
+# 메모 추가 (한/글에서 바로 표시)
+paragraph = doc.paragraphs[0]
+doc.add_memo_with_anchor("검토 필요", paragraph=paragraph)
+
+# 저장
+doc.save("결과물.hwpx")
+```
+
+## 주요 기능
+
+### 📄 문서 편집
+
+문단, 표, 메모, 머리말/꼬리말을 Python 객체로 다룹니다.
+
+```python
+# 머리말·꼬리말
+doc.set_header_text("기밀 문서", page_type="BOTH")
+doc.set_footer_text("— 1 —", page_type="BOTH")
+
+# 표 셀 병합·분할
+table.merge_cells(0, 0, 1, 1)   # (0,0)~(1,1) 병합
+table.set_cell_text(0, 0, "병합된 셀", logical=True, split_merged=True)
+```
+
+### 🔍 텍스트 추출 & 검색
+
+```python
+from hwpx import TextExtractor, ObjectFinder
+
+# 텍스트 추출
+for section in TextExtractor("문서.hwpx"):
+    for para in section.paragraphs:
+        print(para.text)
+
+# 특정 객체 탐색
+for obj in ObjectFinder("문서.hwpx").find("tbl"):
+    print(obj.tag, obj.attributes)
+```
+
+### 🎨 스타일 기반 텍스트 치환
+
+서식(색상, 밑줄, charPrIDRef)으로 런을 필터링해 선택적으로 교체합니다.
+
+```python
+# 빨간색 텍스트만 찾아서 치환
+doc.replace_text_in_runs(
+    "임시", "확정",
+    text_color="#FF0000",
+)
+
+# 특정 서식의 런 검색
+runs = doc.find_runs_by_style(underline_type="SINGLE")
+```
+
+### 🏗️ 저수준 XML 제어
+
+OWPML 스키마에 매핑된 데이터클래스로 XML 구조를 직접 다룹니다.
+
+```python
+# 헤더 참조 목록
+doc.border_fills    # 테두리 채우기
+doc.bullets         # 글머리표
+doc.styles          # 스타일
+doc.track_changes   # 변경 추적
+
+# 바탕쪽·이력·버전 파트
+doc.master_pages
+doc.histories
+doc.version
+```
+
+## 아키텍처
+
+```
+python-hwpx
+├── hwpx.document        # 고수준 편집 API (HwpxDocument)
+├── hwpx.package         # OPC 컨테이너 읽기/쓰기
+├── hwpx.oxml            # OWPML XML ↔ 데이터클래스 매핑
+│   ├── document.py      #   섹션, 문단, 표, 런, 메모
+│   ├── header.py        #   헤더 참조 목록 (스타일, 글머리표, 변경추적 등)
+│   └── body.py          #   타입이 지정된 본문 모델
+├── hwpx.tools
+│   ├── text_extractor   #   텍스트 추출 파이프라인
+│   ├── object_finder    #   객체 탐색 유틸리티
+│   └── validator        #   스키마 유효성 검사 (hwpx-validate CLI)
+└── hwpx.templates       # 내장 빈 문서 템플릿
+```
+
+## CLI
+
+```bash
+# HWPX 문서 스키마 유효성 검사
+hwpx-validate 문서.hwpx
+```
+
+## 문서
+
+| | |
+|---|---|
+| **[📖 전체 문서](https://airmang.github.io/python-hwpx/)** | Sphinx 기반 API 레퍼런스, 사용 가이드, FAQ |
+| **[🚀 빠른 시작](https://airmang.github.io/python-hwpx/quickstart.html)** | 5분 안에 HWPX 문서 다루기 |
+| **[📚 사용 가이드](https://airmang.github.io/python-hwpx/usage.html)** | 50+ 실전 사용 패턴 |
+| **[🔧 API 레퍼런스](https://airmang.github.io/python-hwpx/api_reference.html)** | 클래스·메서드 상세 명세 |
+| **[📐 스키마 개요](https://airmang.github.io/python-hwpx/schema-overview.html)** | OWPML 스키마 구조 설명 |
+
+## 요구 사항
+
+- Python 3.10+
+- lxml ≥ 4.9
+
+## 알려진 제약
+
+`add_shape()` / `add_control()`은 한/글이 요구하는 모든 하위 요소를 생성하지 않습니다.
+복잡한 개체를 추가할 때는 한/글에서 열어 검증해 주세요.
+
+## 기여하기
+
+버그 리포트, 기능 제안, PR 모두 환영합니다.
+개발 환경 설정과 테스트 방법은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요.
+
+```bash
+git clone https://github.com/airmang/python-hwpx.git
+cd python-hwpx
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+[MIT](LICENSE) © 고규현 (Kyuhyun Koh)
+
+<br>
+
+## Author
+
+**고규현** — 광교고등학교 정보·컴퓨터 교사
+
+- ✉️ [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
+- 🐙 [@airmang](https://github.com/airmang)

python_hwpx-2.2/README.md

@@ -0,0 +1,190 @@
+<p align="center">
+  <h1 align="center">python-hwpx</h1>
+  <p align="center">
+    <strong>HWPX 문서를 Python으로 읽고, 편집하고, 생성합니다.</strong>
+  </p>
+  <p align="center">
+    <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>
+    <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/pyversions/python-hwpx" alt="Python"></a>
+    <a href="https://github.com/airmang/python-hwpx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Non--Commercial-green" alt="License"></a>
+    <a href="https://airmang.github.io/python-hwpx/"><img src="https://img.shields.io/badge/docs-Sphinx-8CA1AF" alt="Docs"></a>
+  </p>
+</p>
+
+---
+
+`python-hwpx`는 한컴오피스의 [HWPX 포맷](https://www.hancom.com/)을 순수 Python으로 다루는 라이브러리입니다.
+한/글 설치 없이, OS에 관계없이 HWPX 문서의 구조를 파싱하고 콘텐츠를 조작할 수 있습니다.
+
+> **pyhwpx / pyhwp와 다른 점?**
+> `pyhwpx`는 Windows COM 자동화 기반이라 한/글이 설치된 Windows에서만 동작합니다.
+> `pyhwp`는 레거시 `.hwp`(v5 바이너리) 전용입니다.
+> `python-hwpx`는 OWPML/OPC 기반 `.hwpx`를 직접 파싱하므로 **Linux, macOS, CI 환경 어디서든** 동작합니다.
+
+## 설치
+
+```bash
+pip install python-hwpx
+```
+
+> 유일한 의존성은 `lxml`입니다.
+
+## Quick Start
+
+```python
+from hwpx.document import HwpxDocument
+
+# 기존 문서 열기
+doc = HwpxDocument.open("보고서.hwpx")
+
+# 빈 문서 새로 만들기
+doc = HwpxDocument.new()
+
+# 문단 추가
+doc.add_paragraph("python-hwpx로 생성한 문단입니다.")
+
+# 표 추가 (2×3)
+table = doc.add_table(rows=2, cols=3)
+table.set_cell_text(0, 0, "이름")
+table.set_cell_text(0, 1, "부서")
+table.set_cell_text(0, 2, "연락처")
+
+# 메모 추가 (한/글에서 바로 표시)
+paragraph = doc.paragraphs[0]
+doc.add_memo_with_anchor("검토 필요", paragraph=paragraph)
+
+# 저장
+doc.save("결과물.hwpx")
+```
+
+## 주요 기능
+
+### 📄 문서 편집
+
+문단, 표, 메모, 머리말/꼬리말을 Python 객체로 다룹니다.
+
+```python
+# 머리말·꼬리말
+doc.set_header_text("기밀 문서", page_type="BOTH")
+doc.set_footer_text("— 1 —", page_type="BOTH")
+
+# 표 셀 병합·분할
+table.merge_cells(0, 0, 1, 1)   # (0,0)~(1,1) 병합
+table.set_cell_text(0, 0, "병합된 셀", logical=True, split_merged=True)
+```
+
+### 🔍 텍스트 추출 & 검색
+
+```python
+from hwpx import TextExtractor, ObjectFinder
+
+# 텍스트 추출
+for section in TextExtractor("문서.hwpx"):
+    for para in section.paragraphs:
+        print(para.text)
+
+# 특정 객체 탐색
+for obj in ObjectFinder("문서.hwpx").find("tbl"):
+    print(obj.tag, obj.attributes)
+```
+
+### 🎨 스타일 기반 텍스트 치환
+
+서식(색상, 밑줄, charPrIDRef)으로 런을 필터링해 선택적으로 교체합니다.
+
+```python
+# 빨간색 텍스트만 찾아서 치환
+doc.replace_text_in_runs(
+    "임시", "확정",
+    text_color="#FF0000",
+)
+
+# 특정 서식의 런 검색
+runs = doc.find_runs_by_style(underline_type="SINGLE")
+```
+
+### 🏗️ 저수준 XML 제어
+
+OWPML 스키마에 매핑된 데이터클래스로 XML 구조를 직접 다룹니다.
+
+```python
+# 헤더 참조 목록
+doc.border_fills    # 테두리 채우기
+doc.bullets         # 글머리표
+doc.styles          # 스타일
+doc.track_changes   # 변경 추적
+
+# 바탕쪽·이력·버전 파트
+doc.master_pages
+doc.histories
+doc.version
+```
+
+## 아키텍처
+
+```
+python-hwpx
+├── hwpx.document        # 고수준 편집 API (HwpxDocument)
+├── hwpx.package         # OPC 컨테이너 읽기/쓰기
+├── hwpx.oxml            # OWPML XML ↔ 데이터클래스 매핑
+│   ├── document.py      #   섹션, 문단, 표, 런, 메모
+│   ├── header.py        #   헤더 참조 목록 (스타일, 글머리표, 변경추적 등)
+│   └── body.py          #   타입이 지정된 본문 모델
+├── hwpx.tools
+│   ├── text_extractor   #   텍스트 추출 파이프라인
+│   ├── object_finder    #   객체 탐색 유틸리티
+│   └── validator        #   스키마 유효성 검사 (hwpx-validate CLI)
+└── hwpx.templates       # 내장 빈 문서 템플릿
+```
+
+## CLI
+
+```bash
+# HWPX 문서 스키마 유효성 검사
+hwpx-validate 문서.hwpx
+```
+
+## 문서
+
+| | |
+|---|---|
+| **[📖 전체 문서](https://airmang.github.io/python-hwpx/)** | Sphinx 기반 API 레퍼런스, 사용 가이드, FAQ |
+| **[🚀 빠른 시작](https://airmang.github.io/python-hwpx/quickstart.html)** | 5분 안에 HWPX 문서 다루기 |
+| **[📚 사용 가이드](https://airmang.github.io/python-hwpx/usage.html)** | 50+ 실전 사용 패턴 |
+| **[🔧 API 레퍼런스](https://airmang.github.io/python-hwpx/api_reference.html)** | 클래스·메서드 상세 명세 |
+| **[📐 스키마 개요](https://airmang.github.io/python-hwpx/schema-overview.html)** | OWPML 스키마 구조 설명 |
+
+## 요구 사항
+
+- Python 3.10+
+- lxml ≥ 4.9
+
+## 알려진 제약
+
+`add_shape()` / `add_control()`은 한/글이 요구하는 모든 하위 요소를 생성하지 않습니다.
+복잡한 개체를 추가할 때는 한/글에서 열어 검증해 주세요.
+
+## 기여하기
+
+버그 리포트, 기능 제안, PR 모두 환영합니다.
+개발 환경 설정과 테스트 방법은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요.
+
+```bash
+git clone https://github.com/airmang/python-hwpx.git
+cd python-hwpx
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+[MIT](LICENSE) © 고규현 (Kyuhyun Koh)
+
+<br>
+
+## Author
+
+**고규현** — 광교고등학교 정보·컴퓨터 교사
+
+- ✉️ [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
+- 🐙 [@airmang](https://github.com/airmang)

{python_hwpx-2.0 → python_hwpx-2.2}/pyproject.toml

@@ -1,86 +1,86 @@
-[build-system]
-requires = ["setuptools", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "python-hwpx"
-version = "2.0"
-description = "Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음"
-readme = { file = "README.md", content-type = "text/markdown" }
-license = { file = "LICENSE" }
-requires-python = ">=3.10"
-authors = [
-    { name = "python-hwpx Maintainers" },
-]
-keywords = ["hwp", "hwpx", "hancom", "opc", "xml"]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: Text Processing :: Markup :: XML",
-]
-dependencies = [
-    "lxml>=4.9,<6",
-]
-
-[project.optional-dependencies]
-dev = [
-    "build>=1.0",
-    "twine>=4.0",
-    "pytest>=7.4",
-]
-test = [
-    "pytest>=7.4",
-    "pytest-cov>=5.0",
-]
-typecheck = [
-    "mypy>=1.10",
-    "pyright>=1.1.390",
-]
-
-[project.urls]
-Homepage = "https://github.com/airmang/python-hwpx"
-Documentation = "https://github.com/airmang/python-hwpx/tree/main/docs"
-Issues = "https://github.com/airmang/python-hwpx/issues"
-
-[project.scripts]
-hwpx-validate = "hwpx.tools.validator:main"
-
-[tool.setuptools]
-package-dir = { "" = "src" }
-include-package-data = true
-
-[tool.setuptools.packages.find]
-where = ["src"]
-include = ["hwpx*"]
-
-[tool.setuptools.package-data]
-"hwpx" = ["py.typed"]
-"hwpx.tools" = ["_schemas/*.xsd"]
-"hwpx.data" = ["Skeleton.hwpx"]
-
-[tool.pytest.ini_options]
-pythonpath = ["src"]
-addopts = "-ra"
-testpaths = ["tests"]
-
-
-[tool.mypy]
-python_version = "3.10"
-files = ["src/hwpx/document.py", "src/hwpx/oxml/document.py"]
-ignore_missing_imports = true
-
-[[tool.mypy.overrides]]
-module = ["hwpx.document", "hwpx.oxml.document"]
-ignore_errors = true
-
-[tool.pyright]
-include = ["src/hwpx/document.py", "src/hwpx/oxml/document.py"]
-pythonVersion = "3.10"
-typeCheckingMode = "off"
-reportMissingTypeStubs = false
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-hwpx"
+version = "2.2"
+description = "Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음"
+readme = { file = "README.md", content-type = "text/markdown" }
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+authors = [
+    { name = "python-hwpx Maintainers" },
+]
+keywords = ["hwp", "hwpx", "hancom", "opc", "xml"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Text Processing :: Markup :: XML",
+]
+dependencies = [
+    "lxml>=4.9,<6",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.0",
+    "twine>=4.0",
+    "pytest>=7.4",
+]
+test = [
+    "pytest>=7.4",
+    "pytest-cov>=5.0",
+]
+typecheck = [
+    "mypy>=1.10",
+    "pyright>=1.1.390",
+]
+
+[project.urls]
+Homepage = "https://github.com/airmang/python-hwpx"
+Documentation = "https://github.com/airmang/python-hwpx/tree/main/docs"
+Issues = "https://github.com/airmang/python-hwpx/issues"
+
+[project.scripts]
+hwpx-validate = "hwpx.tools.validator:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["hwpx*"]
+
+[tool.setuptools.package-data]
+"hwpx" = ["py.typed"]
+"hwpx.tools" = ["_schemas/*.xsd"]
+"hwpx.data" = ["Skeleton.hwpx"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+addopts = "-ra"
+testpaths = ["tests"]
+
+
+[tool.mypy]
+python_version = "3.10"
+files = ["src/hwpx/document.py", "src/hwpx/oxml/document.py"]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = ["hwpx.document", "hwpx.oxml.document"]
+ignore_errors = true
+
+[tool.pyright]
+include = ["src/hwpx/document.py", "src/hwpx/oxml/document.py"]
+pythonVersion = "3.10"
+typeCheckingMode = "off"
+reportMissingTypeStubs = false