hangulpy 1.3.1

A comprehensive Python library for Korean language processing, inspired by es-hangul

hangulpy

hangulpy는 es-hangul에서 영감을 받아 만든 파이썬 한글 처리 라이브러리입니다. 조사 자동 선택, 초성/부분 음절 검색, 자모 분해/조합, 로마자 표기, 숫자 변환, 한영타 교정까지 한 곳에서 제공합니다.

주요 기능

• 조사 자동 선택: josa, has_jongsung
• 초성/부분 음절 검색: get_chosung_string, chosungIncludes, hangul_contains, hangul_search, HangulSearcher
• 한글 속성 검사: is_hangul, is_complete_hangul, get_hangul_components
• 자모 분해/조합: decompose_hangul_string, split_hangul_string, split_syllables, join_jamos, hangul_syllable
• 변환 기능: romanize, Romanizer, number_to_hangul, hangul_to_number, koen, enko, autofix

설치

pip install hangulpy

업그레이드는 아래처럼 진행할 수 있습니다.

pip install -U hangulpy

빠른 예시

from hangulpy import (
    HangulSearcher,
    get_hangul_components,
    join_jamos,
    josa,
    romanize,
)

print(josa("사과", "을/를"))  # 사과를

searcher = HangulSearcher("ㅅㄱ")
print(searcher.search("사과는 맛있다"))  # True

print(get_hangul_components("한"))  # ('ㅎ', 'ㅏ', 'ㄴ')
print(join_jamos(["ㅎ", "ㅏ", "ㄴ", "ㄱ", "ㅡ", "ㄹ"]))  # 한글
print(romanize("광희문", "revised"))  # gwanghuimun
print(romanize("오죽헌", "revised", mode="proper", capitalize=True))  # Ojukheon
print(romanize("충청북도", "revised", mode="admin"))  # chungcheongbuk-do

문서

• 공식 문서
• 로마자 표기 문서

예제

• 빠른 실행 예제: examples/quickstart.py

기여

이슈, PR, 문서 개선 모두 환영합니다.