From af5c886c28e83d83ab8a68b843e03c33c87808f7 Mon Sep 17 00:00:00 2001 From: Sumin Byeon Date: Thu, 25 Apr 2024 01:39:29 +0900 Subject: [PATCH 1/3] docs: Revise README --- README.rst | 88 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 51 insertions(+), 37 deletions(-) diff --git a/README.rst b/README.rst index 283fd0e..2f3780c 100644 --- a/README.rst +++ b/README.rst @@ -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 --------------------- @@ -36,21 +29,26 @@ 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번째 자음, 'ㅏ'는 첫번째 모음, 'ㄴ'은 다섯번째 자음이라는 것을 알 수 있다. @@ -58,17 +56,21 @@ Usage 초성, 중성, 종성을 조합하여 한 글자를 만듦 `````````````````````````````````````````` ->>> 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 한글로 된 부분과 한자로 된 부분을 분리 @@ -76,40 +78,52 @@ 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') -'大韓民國(대한민국)은 民主共和國(민주공화국)이다.' +.. code-block:: python + + >>> hanja.translate(u'大韓民國은 民主共和國이다.', 'combination-html') + '大韓民國(대한민국)은 民主共和國(민주공화국)이다.' From 5969f458cc0bdf9ea5513a42389cbdc191e25208 Mon Sep 17 00:00:00 2001 From: Sumin Byeon Date: Fri, 31 May 2024 15:35:30 +0800 Subject: [PATCH 2/3] build: Use setuptools instead of distutils (#25) --- setup.py | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/setup.py b/setup.py index 756dfc6..5ddfe26 100644 --- a/setup.py +++ b/setup.py @@ -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 @@ -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, From 1fcac8cad9a692d10d08703516e3f570cec886d0 Mon Sep 17 00:00:00 2001 From: Sumin Byeon Date: Fri, 31 May 2024 16:37:03 +0900 Subject: [PATCH 3/3] build: Update version (0.14.1) --- hanja/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hanja/__init__.py b/hanja/__init__.py index 74e0187..26aab65 100644 --- a/hanja/__init__.py +++ b/hanja/__init__.py @@ -9,7 +9,7 @@ __all__ = ["is_hanja", "is_valid_mode", "split_hanja", "translate"] __author__ = "Sumin Byeon" __email__ = "suminb@gmail.com" -__version__ = "0.14.0" +__version__ = "0.14.1" # Copied from https://wiki.python.org/moin/PythonDecoratorLibrary