Skip to content

Commit

Permalink
Merge branch 'release/v0.14.1'
Browse files Browse the repository at this point in the history
  • Loading branch information
suminb committed May 31, 2024
2 parents 3bc2f09 + 1fcac8c commit e892eda
Show file tree
Hide file tree
Showing 3 changed files with 54 additions and 41 deletions.
88 changes: 51 additions & 37 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,17 +1,10 @@
hanja: 한자-한글 변환 라이브러리
================================

|Travis CI| |Coveralls|

`한자-한글 변환기`__\ 에서 사용되는 모듈입니다.

__ http://hanja.suminb.com

.. |Travis CI| image:: https://travis-ci.org/suminb/hanja.svg?branch=develop
:target: https://travis-ci.org/suminb/hanja
.. |Coveralls| image:: https://coveralls.io/repos/github/suminb/hanja/badge.svg?branch=master
:target: https://coveralls.io/github/suminb/hanja?branch=develop


Improve Hanja Library
---------------------
Expand All @@ -36,80 +29,101 @@ Usage
필요한 모듈 import 하기
```````````````````````

>>> import hanja
>>> from hanja import hangul
.. code-block:: python
>>> import hanja
>>> from hanja import hangul
한글 초성, 중성, 종성 분리
``````````````````````````
.. code-block:: python
>>> hangul.separate('')
(0, 0, 0)
>>> hangul.separate('')
(1, 0, 0)
>>> hangul.separate('')
(0, 0, 0)
>>> hangul.separate('')
(1, 0, 0)
튜플(tuple)의 마지막 원소가 0이면 종성이 없는 글자라고 판단할 수 있다.

>>> hangul.separate('')
(18, 0, 4)
.. code-block:: python
>>> hangul.separate('')
(18, 0, 4)
'ㅎ'은 19번째 자음, 'ㅏ'는 첫번째 모음, 'ㄴ'은 다섯번째 자음이라는 것을 알 수 있다.


초성, 중성, 종성을 조합하여 한 글자를 만듦
``````````````````````````````````````````

>>> hangul.build(0, 0, 0)
'가'
.. code-block:: python
>>> hangul.build(0, 0, 0)
''
주어진 글자가 한글인지의 여부를 판별
````````````````````````````````````

>>> hangul.is_hangul('')
True
>>> hangul.is_hangul('a')
False
.. code-block:: python
>>> hangul.is_hangul('')
True
>>> hangul.is_hangul('a')
False
한글로 된 부분과 한자로 된 부분을 분리
``````````````````````````````````````

리스트가 아닌 제네레이터(generator)를 반환한다.

>>> '|'.join(hanja.split_hanja('大韓民國은 民主共和國이다.'))
大韓民國|은 |民主共和國|이다.
.. code-block:: python
>>> [x for x in hanja.split_hanja('大韓民國은 民主共和國이다.')]
['大韓民國', '은 ', '民主共和國', '이다.']
>>> '|'.join(hanja.split_hanja('大韓民國은 民主共和國이다.'))
大韓民國||民主共和國|이다.
>>> [x for x in hanja.split_hanja('大韓民國은 民主共和國이다.')]
['大韓民國', '', '民主共和國', '이다.']
주어진 글자가 한자인지의 여부를 판별
````````````````````````````````````

>>> hanja.is_hanja('')
True
.. code-block:: python
>>> hanja.is_hanja('')
True
>>> hanja.is_hanja('')
False
>>> hanja.is_hanja('')
False
문장 변환
`````````

치환 모드 변환:

>>> hanja.translate('大韓民國은 民主共和國이다.', 'substitution')
'대한민국은 민주공화국이다.'
.. code-block:: python
>>> hanja.translate('大韓民國은 民主共和國이다.', 'substitution')
'대한민국은 민주공화국이다.'
혼용 모드 변환 (text):

>>> hanja.translate('大韓民國은 民主共和國이다.', 'combination-text')
'大韓民國(대한민국)은 民主共和國(민주공화국)이다.'
.. code-block:: python
>>> hanja.translate('大韓民國은 民主共和國이다.', 'combination-text')
'大韓民國(대한민국)은 民主共和國(민주공화국)이다.'
혼용 모드 변환 version 2 (text):

>>> hanja.translate('大韓民國은 民主共和國이다.', 'combination-text-reversed')
'대한민국(大韓民國)은 민주공화국(民主共和國)이다.'
.. code-block:: python
>>> hanja.translate('大韓民國은 民主共和國이다.', 'combination-text-reversed')
'대한민국(大韓民國)은 민주공화국(民主共和國)이다.'
혼용 모드 변환 (HTML):

>>> hanja.translate(u'大韓民國은 民主共和國이다.', 'combination-html')
'<span class="hanja">大韓民國</span><span class="hangul">(대한민국)</span>은 <span class="hanja">民主共和國</span><span class="hangul">(민주공화국)</span>이다.'
.. code-block:: python
>>> hanja.translate(u'大韓民國은 民主共和國이다.', 'combination-html')
'<span class="hanja">大韓民國</span><span class="hangul">(대한민국)</span>은 <span class="hanja">民主共和國</span><span class="hangul">(민주공화국)</span>이다.'
2 changes: 1 addition & 1 deletion hanja/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
__all__ = ["is_hanja", "is_valid_mode", "split_hanja", "translate"]
__author__ = "Sumin Byeon"
__email__ = "[email protected]"
__version__ = "0.14.0"
__version__ = "0.14.1"


# Copied from https://wiki.python.org/moin/PythonDecoratorLibrary
Expand Down
5 changes: 2 additions & 3 deletions setup.py
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
#!/usr/bin/env python

from distutils.core import setup
from setuptools import setup, find_packages
from pkg_resources import parse_requirements

import hanja
Expand All @@ -19,14 +19,13 @@ def readme():

setup(
name="hanja",
py_modules=["hanja", "hanja/__init__", "hanja.hangul"],
version=hanja.__version__,
description="Hangul & Hanja library",
long_description=readme(),
author=hanja.__author__,
author_email=hanja.__email__,
url="https://github.com/suminb/hanja",
packages=[],
packages=find_packages(include=["hanja", "hanja.*"]),
package_data={"": ["requirements.txt"], "hanja": ["table.yml"]},
include_package_data=True,
install_requires=install_requires,
Expand Down

0 comments on commit e892eda

Please sign in to comment.