Metadata-Version: 2.4
Name: hanja-tools
Version: 0.1.0
Summary: Korean Hanja utilities: stroke count, five-elements (ohaeng), and personal-name character filter
Project-URL: Homepage, https://github.com/hyun/hanja-tools
Project-URL: Repository, https://github.com/hyun/hanja-tools
License: MIT
License-File: LICENSE
Keywords: chinese-characters,hanja,inmyong,korean,ohaeng,stroke
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.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.11
Requires-Dist: hanja>=0.14.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# hanja-tools

한국 한자(漢字) 관련 기능을 통합한 Python 패키지입니다.  
`suminb/hanja`가 제공하지 않는 **획수·오행·인명용 필터·검색** 기능을 추가합니다.

## 설치

```bash
pip install hanja-tools
```

## 빠른 시작

```python
from hanja_tools import HanjaDB

db = HanjaDB()

db.get_eum('松')        # '송'  — 한글 음 (suminb/hanja 기반)
db.get_stroke('松')     # 8     — 획수 (Unihan kTotalStrokes)
db.get_ohaeng('松')     # '金'  — 오행 (수리오행법: 8획 끝자리 8 → 金)
db.is_inmyong('松')     # True  — 인명용 한자 여부 (대법원 기준)
db.info('松')
# {'char': '松', 'eum': '송', 'stroke': 8, 'ohaeng': '金', 'inmyong': True}

# 검색
db.search_by_eum('송')           # ['松', '誦', '頌', ...]
db.search_by_stroke(8)           # 8획 한자 목록
db.search_by_ohaeng('木')        # 木 오행 한자 목록
db.search(eum='송', inmyong=True) # 복합 조건
```

## 오행 분류표 (수리오행법)

| 획수 끝자리 | 오행 |
|---|---|
| 1, 2 | 木 |
| 3, 4 | 火 |
| 5, 6 | 土 |
| 7, 8 | 金 |
| 9, 0 | 水 |

## 데이터 출처

| 데이터 | 출처 | 라이선스 |
|---|---|---|
| 한자→음 | `suminb/hanja` table.yml (27,497자) | CC0 |
| 획수 | Unicode Unihan Database `kTotalStrokes` | Unicode License |
| 인명용 한자 | `rutopio/Korean-Name-Hanja-Charset` data-gov.csv | MIT |

## 라이선스

MIT
