Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/what-studio/smartformat-korean
Korean extension for SmartFormat-Python
https://github.com/what-studio/smartformat-korean
Last synced: about 1 month ago
JSON representation
Korean extension for SmartFormat-Python
- Host: GitHub
- URL: https://github.com/what-studio/smartformat-korean
- Owner: what-studio
- License: bsd-3-clause
- Created: 2016-05-27T02:38:09.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-06-22T02:16:00.000Z (over 7 years ago)
- Last Synced: 2024-03-15T11:04:38.402Z (9 months ago)
- Language: Python
- Homepage:
- Size: 69.3 KB
- Stars: 24
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hangul - SmartFormat-Korean - Korean extension for SmartFormat-Python (Programming Languages / Python)
README
# SmartFormat-Korean
[](
https://travis-ci.org/what-studio/smartformat-korean)
[](
https://coveralls.io/r/what-studio/smartformat-korean)
[Python 용 SmartFormat][smartformat-python]에서 쓸 수 있는 한국어 확장입니다.
[SmartFormat.NET][smartformat-net]을 쓴다면 [C# 구현][smartformat-net-korean]을
사용해주세요.
[smartformat-python]: https://github.com/what-studio/smartformat
[smartformat-net]: https://github.com/scottrippey/SmartFormat.NET
[smartformat-net-korean]: https://github.com/what-studio/smartformat.net-korean
## 설치
```console
$ pip install smartformat-korean
```
## 사용법
```python
>>> from smartformat import SmartFormatter
>>> from smartformat.ext.korean import ko
>>> smart = SmartFormatter('ko_KR', [ko])
>>> smart.format(u'{subj:는} {obj:다}.', subj=u'대한민국', obj=u'민주공화국')
대한민국은 민주공화국이다.
```
## 자연스러운 조사 선택
`의`, `도`, `만~`, `에~`, `께~`, `뿐~`, `하~`, `보다~`, `밖에~`, `같이~`,
`부터~`, `까지~`, `마저~`, `조차~`, `마냥~`, `처럼~`, `커녕~`에는 어떤 단어가
앞서도 형태가 변하지 않습니다:
> 나오**의**, 모리안**의**, 키홀**의**, 나오**도**, 모리안**도**, 키홀**도**
반면 `은(는)`, `이(가)`, `을(를)`, `과(와)~`는 앞선 단어의 마지막 음절의 받침
유무에 따라 형태가 달라집니다:
> 나오**는**, 모리안**은**, 키홀**은**
`(으)로~`도 비슷한 규칙을 따르지만 앞선 받침이 `ㄹ`일 경우엔 받침이 없는 것과
같게 취급합니다:
> 나오**로**, 모리안**으로**, 키홀**로**
서술격 조사 `(이)다`는 어미가 활용되어 다양한 형태로 변형될 수 있습니다:
> 나오**지만**, 모리안**이지만**, 키홀**이에요**, 나오**예요**
SmartFormat 한국어 확장은 자동으로 가장 자연스러운 조사 형태를 선택합니다.
만약 어떤 형태가 자연스러운지 알 수 없을 때에는 `은(는)`, `(으)로`처럼
모든 형태를 병기합니다:
```python
>>> smart.format(u'{name:은} {alt:로} 불린다.', name=u'나오', alt=u'검은사신')
나오는 검은사신으로 불린다.
>>> smart.format(u'바로 {name:이에요}.', name=u'나오')
바로 나오예요.
>>> smart.format(u'{material:로} 만들었다.', material=u'벽돌')
벽돌로 만들었다.
>>> smart.format(u'{material:로} 만들었다.', material=u'짚')
짚으로 만들었다.
>>> smart.format(u'{material:로} 만들었다.', material=u'黃金')
黃金(으)로 만들었다.
```
단어가 숫자로 끝나더라도 자연스러운 조사 형태가 선택됩니다:
```python
>>> smart.format(u'{level:이} 되었다.', level=u'레벨 10')
레벨 10이 되었다.
>>> smart.format(u'{level:이} 되었다.', level=u'레벨 999')
레벨 999가 되었다.
```
괄호 속 단어는 조사 형태를 선택할 때 참고하지 않습니다:
```python
>>> smart.format(u'{item:을} 얻었다.', level=u'나뭇가지(만렙)')
나뭇가지(만렙)를 얻었다.
```
## 병기 순서
조사의 형태를 모두 병기해야할 때 병기할 순서를 고를 수 있습니다. 가령 대부분의
인자가 일본어 단어일 경우엔 단어가 모음으로 끝날 확률이 높습니다. 이 경우
기본형인 `은(는)` 스타일보단 `는(은)` 스타일이 더 자연스러울 수 있습니다:
```python
>>> from smartformat.ext.korean import KoreanExtension
>>> smart = SmartFormatter('ko_KR', [KoreanExtension(u'는(은)')])
>>> smart.format(u'{flower:이} 곱게 피었다.', flower=u'さくら')
さくら가(이) 곱게 피었다.
```
`은(는)`, `(은)는`, `는(은)`, `(는)은` 네 가지 스타일 중 프로젝트에 맞는 것을
고르세요.
## 만든이와 사용권
[넥슨][nexon] [왓 스튜디오][what-studio]의 [이흥섭][sublee]과
[김찬웅][kexplo]이 만들었고 [제3조항을 포함하는 BSD 허가서][bsd-3-clause]를
채택했습니다.
[nexon]: http://nexon.com/
[what-studio]: https://github.com/what-studio
[sublee]: http://subl.ee/
[kexplo]: http://chanwoong.kim/
[bsd-3-clause]: http://opensource.org/licenses/BSD-3-Clause