Hangulpy

2달 정도 걸렸네요. 1.2.0 버전을 릴리즈했습니다. 다음 사항이 수정 되었습니다!

* [개선] [한글 문자열 정렬 기능 추가 7](https://github.com/gaon12/hangulpy/issues/7)
* [개선] [split_hangul_char 함수 deprecated 하기 8](https://github.com/gaon12/hangulpy/issues/8)
* [개선] [decompose_hangul_char 함수를 decompose_hangul_string 함수로 대체하기 10](https://github.com/gaon12/hangulpy/issues/10)
* [개선] [한영타 오타 수정 기능 추가 11](https://github.com/gaon12/hangulpy/issues/11)
* [개선] [초성-중성-종성 조합 기능 12](https://github.com/gaon12/hangulpy/issues/12)

`1.2.0`에서는 드.디.어! `문자열`을 지원하지 않는(즉 `단일 문자`만 지원하는) 함수를 제거했습니다.

1. `split_hangul_char`, `decompose_hangul_char`, `is_hangul_char` 함수 제거
단일 문자만 지원하는 함수들은 이젠 사용이 불가능합니다. 전 버전에서 미리 deprecated warning을 띄었기 때문에 충분히 수정하셨을 거라 생각됩니다.

2. 한글 문자열 정렬 시, 역순 정렬 지원
`sort_hangul` 함수로 정렬 시, 역순 정렬을 지원합니다. `reverse=False` 옵션을 주면 역순으로 정렬합니다.
python
from hangulpy import sort_hangul

words = ['가나', '다라', '나가']
print(sort_hangul(words)) 출력: ['가나', '나가', '다라']
print(sort_hangul(words, reverse=False)) 출력: ['다라', '나가', '가나']


3. 한영타 오타 수정
[inko.js 라이브러리](https://github.com/738/inko)에서 영감을 받았습니다! 한영타 오타를 교정해줍니다. 한글 → 알파벳 또는 알파벳 → 한글 모두 가능합니다. `koen`, `enko`, `autofix`로 사용 가능합니다.

python
from hangulpy import koen, enko, autofix

typoerr_hangul = "ㅗ디ㅣㅐ 재깅!" hello world!
typoerr_alphabet = "sork djeldp dlTems chltjsdmf ekgksms rjtdl wnddygkek." 내가 어디에 있든 최선을 다하는 것이 중요하다.
typoerr_mix = "dl rytnsladms 뭏디dlek!" 이 교수님은 angel이다!

print(koen(typoerr_hangul))
print(enko(typoerr_alphabet))
print(autofix(typoerr_mix))


한글 → 알파벳의 경우, 일부 글자(ㅛ, ㅕ, ㅑ, ㅁ, ㄴ, ㅇ, ㄹ, ㅎ, ㅗ, ㅓ, ㅏ, ㅣ, ㅋ, ㅌ, ㅊ, ㅍ, ㅠ, ㅜ, ㅡㅈ)는 대문자 변환이 되지 않습니다. 키보드에 대문자를 구분할 수 없는 키이기 때문입니다.

4. 초성-중성-종성 조합
초성, 중성, 종성 부분에 해당하는 글자를 입력받으면, 올바른지 확인 후 완성형 문자를 출력합니다.

python
from hangulpy import hangul_syllable

print(hangul_syllable("ㄱ", "ㅏ")) 가
print(hangul_syllable("ㄱ", "ㅏ", "ㄱ")) 각
print(hangul_syllable("ㄱ", "ㄴ")) Exception: Error: 'ㄴ' is not a valid medial vowel.
print(hangul_syllable("ㅓ", "ㅏ", "ㄱ")) Exception: Error: 'ㅓ' is not a valid initial consonant.
print(hangul_syllable("a", "ㅏ", "ㄱ")) Exception: Error: 'a' is not a valid initial consonant.
print(hangul_syllable("ㄱ", "ㅏ", "l")) Exception: Error: 'l' is not a valid final consonant.


초성, 중성, 종성에 올 수 없는 문자가 있는 경우, 오류를 반환합니다.

--------

패키지 업데이트는 다음과 같이 하면 됩니다.
bash
pip install hangulpy -U


버그나 기능 개선, 기타 내용들은 이슈로 알려주세요! Pull Request도 언제나 환영입니다!

* [개선] [한글 문자열 정렬 기능 추가 7](https://github.com/gaon12/hangulpy/issues/7)
* [개선] [split_hangul_char 함수 deprecated 하기 8](https://github.com/gaon12/hangulpy/issues/8)
* [개선] [내부적으로 사용되는 is_hangul_char 함수 대체 9](https://github.com/gaon12/hangulpy/issues/9)
* [개선] [decompose_hangul_char 함수를 decompose_hangul_string 함수로 대체하기 10](https://github.com/gaon12/hangulpy/issues/10)
* [개선] [매칭 패턴 찾기](https://wiki.uiharu.dev/w/hangulpy#s-3.11)

`1.1.1`에서는 `문자열`을 지원하지 않는(즉 `단일 문자`만 지원하는) 함수를 deprecated 시키는데 집중했습니다.

1. `split_hangul_char` 함수 deprecated 하기
이젠 `split_hangul_char` 함수를 deprecated warning을 띄우도록 했습니다. 물론 warning 패키지를 임포트하여 출력을 안하게 할 수 있지만, 다음 버전(`1.2.0`)에서는 해당 함수를 아예 삭제시킬 예정입니다. 그 대신 `split_hangul_string`을 사용하세요!

2. `decompose_hangul_char` 함수 deprecated 하기
`split_hangul_char`와 마찬가지로 `decompose_hangul_char` 함수도 deprecated warning을 띄우도록 했습니다. 그 대신 `decompose_hangul_string`을 사용하세요!

3. 내부적으로 사용되는 is_hangul_char 함수 대체
1, 2번과 일맥상통하는 부분입니다. 다만 해당 함수는 외부에서는 사용할 수 없고, 내부적으로만 사용 가능했기 때문에, 패치했습니다. 이와 더불어 수정하는데 사용한 함수인 `is_hangul` 함수를 이젠 외부에서 사용할 수 있습니다. 다음과 같이 사용하면 됩니다!

python
from hangulpy import is_hangul
 
print(is_hangul("가")) True
print(is_hangul("반가워요")) True
print(is_hangul("hello")) False
print(is_hangul("a안녕")) False
print(is_hangul("안녕 하세요")) False
print(is_hangul("안녕 하세요", spaces=True)) True
print(is_hangul(123)) False


입력된 값이 한글인지 여부를 확인합니다. 예를 들어 '안녕'은 **True**를, 'Hello'는 **False**를 반환합니다. 기본적으로 공백이 포함되면 **False**를 반환하지만, **'spaces=True'** 옵션을 주면 공백을 제거 후 고려하게 됩니다.

4. 한글 문자열 정렬 기능 추가
배열 안에 있는 글자들을 정렬합니다.

python
from hangulpy import sort_hangul

words = ['가나', '다라', '나가']
print(sort_hangul(words)) 출력: ['가나', '나가', '다라']


5. 매칭 패턴 찾기
주어진 단어 리스트에서 특정 초성, 중성, 종성 패턴에 매칭되는 단어를 찾습니다.

python
from hangulpy import match_hangul_pattern

words = ['가구', '나무', '가방']
pattern1 = 'ㄱ*'
print(match_hangul_pattern(words, pattern1)) ['가구', '가방']

pattern2 = '*ㅜ'
print(match_hangul_pattern(words, pattern2)) ['가구', '나무']


--------

패키지 업데이트는 다음과 같이 하면 됩니다.
bash
pip install hangulpy -U


버그나 기능 개선, 기타 내용들은 이슈로 알려주세요! Pull Request도 언제나 환영입니다!

--------

**[Q&A]**
1. 한글 문자열 정렬 기능 추가에서, 역순 정렬은 지원 안하나요?
- 현재는 지원하지 않습니다. 다만 다음 버전에는 추가될 수도 있습니다. ~~이건 개발자의 귀차니즘 때문이니 이슈로 많이많이 적어주세요~~

- `get_chosung` 함수 제거로 인해 버전을 크게 바꿨습니다.

- `1.0.4` 버전에서는 `warning` 문구에 오타가 있어 수정 후 `1.0.5`로 릴리즈 했습니다.
2. `Deprecated Warning`을 제거할 수 있나요?
- 네. 가능합니다.

python
import warnings

DeprecationWarning 경고를 무시하도록 설정
warnings.filterwarnings("ignore", category=DeprecationWarning)

from hangulpy import get_chosung

text = "가"
print(get_chosung(text)) ㄱ


이런 방식으로 하면 `Deprecated Warning`이 뜨지 않습니다. 다만 다음 버전에서는 제거되므로, 완벽하게 호환되는 `get_chosung_string`을 사용하는 것을 권장합니다!

* [기능추가] [초성 반환 기능 추가 2](https://github.com/gaon12/hangulpy/issues/2)

`1.0.3`에서는 문자열의 초성 반환 기능이 추가되었습니다.

python
from hangulpy import get_chosung_string

text = "대한민국"
print(get_chosung_string(text)) ㄷㅎㅁㄱ

이런식으로 사용하면 됩니다. 한글이 아닌 문자(숫자나 알파벳 등)는 그대로 반환됩니다.

만약 문자열에 띄어쓰기가 있는 경우, 기본적으로 공백 없이 반환됩니다. 예를 들어 `대한 사람 대한으로 길이 보전하세` 문구를 기본값으로 사용 시, `ㄷㅎㅅㄹㄷㅎㅇㄺㅇㅂㅈㅎㅅ`로 반환되는데, 함수에 `keep_spaces=True` 옵션을 준다면, `ㄷㅎ ㅅㄹ ㄷㅎㅇㄹ ㄱㅇ ㅂㅈㅎㅅ`으로 반환합니다.

python
from hangulpy import get_chosung_string

text = "대한 사람 대한으로 길이 보전하세"
print(get_chosung_string(text, keep_spaces=True)) ㄷㅎ ㅅㄹ ㄷㅎㅇㄹ ㄱㅇ ㅂㅈㅎ


이것과 별도로 문서에는 명시되어 있지 않았지만, 문자에 대한 초성 반환 기능도 있습니다. 자세한 내용은 [위키 문서](https://wiki.uiharu.dev/w/hangulpy)를 참고하세요!

--------

패키지 업데이트는 다음과 같이 하면 됩니다.
bash
pip install hangulpy -U


버그나 기능 개선, 기타 내용들은 이슈로 알려주세요! Pull Request도 언제나 환영입니다!

* [버그] [배열로 초/중/종성 분해 오류 1](https://github.com/gaon12/hangulpy/issues/1)

문서 정리 중에 발견한 버그였습니다. 이런 버그들이 많을것으로 예상되오니, 적극적인 이슈 리포팅을 해주시면 감사하겠습니다!

패키지 업데이트는 다음과 같이 하면 됩니다.
bash
pip install hangulpy -U