Metadata-Version: 2.2
Name: pyhwpx
Version: 0.45.2
Summary: 아래아한글 자동화를 위한 파이썬 모듈 pyhwpx입니다.
Home-page: https://blog.naver.com/pythonrpa/
Author: ilco
Author-email: martinii.fun@gmail.com
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >= 3.10
Description-Content-Type: text/markdown
License-File: license.txt
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: pywin32
Requires-Dist: openpyxl
Requires-Dist: pyperclip
Requires-Dist: Pillow
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

## 🐍 PyHWPX: Python 기본 아래아한글 자동화 모듈

**PyHWPX**는 `pywin32` 패키지를 활용하여 아래아한글(HWP) 문서를 자동화할 수 있는 Python 모듈입니다.  
현재 **`Hwp`** 클래스가 포함되어 있으며, **HwpAutomation에서 제공하는 모든 저수준 API 메서드의 사용법, 파라미터 및 예시 코드**를 추가하는 작업이 진행 중입니다.  

👉 한글 문서 업무 자동화에 많이 사용되는 **패턴들을 추가**하며, 보다 **실용적인 오픈소스 라이브러리**로 발전시킬 계획입니다.  
💡 유용한 **컴즐 메서드**도 지적적으로 업데이트할 예정입니다.

---

## **📌 주요 기능**
- **아래아한글 문서 조작**: 텍스트 삽입, 저장, 문서 편집 자동화
- **HwpAutomation API 래핑**: `pywin32`를 사용하여 Hwp 명령 실행
- **집권적인 인스턴스**: 기존 `win32com` 방식보다 쉬욤 사용법 제공
- **컴즐 기능 추가 예정**: 문서 서식 설정, 표 삽입 등 기능 확장 가능  

---

## **🚀 설치 방법**
PyHWPX는 **PyPI(Python Package Index)**에 등록되어 있으며, 아래 명령에서 간편하게 설치할 수 있습니다.

```bash
pip install pyhwpx
```

> ⚠️ **주의:** PyHWPX는 **Windows** 환경에서 작동하며, **한/글이 설치되어 있어야** 합니다.  
> 💡 `pywin32`가 필요하며, `pip install pywin32`로 별도로 설치할 수도 있습니다.
> ✨ **Python 3.10 이상이 필요합니다.**

설치가 완료되면 Python에서 보복 없이 `import`하여 사용할 수 있습니다.

---

## **💡 사용법 예제**
```python
from pyhwpx import Hwp

hwp = Hwp()

# 텍스트 삽입
hwp.insert_text("Hello world!")

# win32com 방식으로 실행
pset = hwp.HParameterSet.HInsertText
pset.Text = "Hello world!"
hwp.HAction.Execute("InsertText", pset.HSet)

# 문서 저장
hwp.save_as("./helloworld.hwp")

# 한/글 종료
hwp.quit()
```

