한글 Unicode 정규화 - hangulpy

normalize_hangul

normalize_hangul(
    text: str,
    form: Literal["NFC", "NFD", "HCJ"] = "NFC",
) -> str

NFC는 조합된 완성형, NFD는 Unicode canonical Jamo, HCJ는 호환 자모 형태를 반환합니다. 호환 자모가 들어 있는 입력은 문맥상 조합 가능한 부분만 먼저 조합합니다.

import unicodedata

from hangulpy import normalize_hangul

nfd = unicodedata.normalize("NFD", "한글")
print(normalize_hangul(nfd))  # 한글
print(normalize_hangul("ㅎㅏㄴㄱㅡㄹ"))  # 한글
print(normalize_hangul("한글", "HCJ"))  # ㅎㅏㄴㄱㅡㄹ

to_jamo / to_compat_jamo

to_jamo(text: str, compatibility: bool = False) -> str
to_compat_jamo(text: str) -> str

to_jamo는 기본적으로 NFD canonical Jamo를 반환하고, compatibility=True이면 호환 자모를 반환합니다. to_compat_jamo는 완성형과 canonical Jamo를 바로 호환 자모로 변환하는 단축 함수입니다.

from hangulpy import to_compat_jamo, to_jamo

print(to_jamo("한"))  # 한
print(to_jamo("한", compatibility=True))  # ㅎㅏㄴ
print(to_compat_jamo("한"))  # ㅎㅏㄴ