Kana kanji simple inversion library
.. image:: https://readthedocs.org/projects/pykakasi/badge/?version=latest :target: https://pykakasi.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status
.. image:: https://badge.fury.io/py/pykakasi.png :target: http://badge.fury.io/py/Pykakasi :alt: PyPI version
.. image:: https://github.com/miurahr/pykakasi/workflows/Run%20Tox%20tests/badge.svg :target: https://github.com/miurahr/pykakasi/actions?query=workflow%3A%22Run+Tox+tests%22 :alt: Run Tox tests
.. image:: https://dev.azure.com/miurahr/github/_apis/build/status/miurahr.pykakasi?branchName=master :target: https://dev.azure.com/miurahr/github/_build?definitionId=13&branchName=master :alt: Azure-Pipelines
.. image:: https://coveralls.io/repos/miurahr/pykakasi/badge.svg?branch=master :target: https://coveralls.io/r/miurahr/pykakasi?branch=master :alt: Coverage status
pykakasi
is a Python Natural Language Processing (NLP) library to transliterate hiragana, katakana and kanji (Japanese text) into rōmaji (Latin/Roman alphabet). It can handle characters in NFC form.
Its algorithms are based on the kakasi
_ library, which is written in C.
PyPI
_): pip install pykakasi
Documentation available on readthedocs
_.. _PyPI
: https://pypi.org/project/pykakasi/
.. _kakasi
: http://kakasi.namazu.org/
.. _Documentation available on readthedocs
: https://pykakasi.readthedocs.io/en/latest/index.html
Transliterate Japanese text to kana, hiragana and romaji:
.. code-block:: python
import pykakasi
kks = pykakasi.kakasi()
text = "かな漢字"
result = kks.convert(text)
for item in result:
print("{}: kana '{}', hiragana '{}', romaji: '{}'".format(item['orig'], item['kana'], item['hira'], item['hepburn']))
かな: kana 'カナ', hiragana: 'かな', romaji: 'kana'
漢字: kana 'カンジ', hiragana: 'かんじ', romaji: 'kanji'
Here is an example that output as similar with furigana mode.
.. code-block:: python
import pykakasi
kks = pykakasi.kakasi()
text = "かな漢字交じり文"
result = kks.convert(text)
for item in result:
print("{}[{}] ".format(item['orig'], item['hepburn'].capitalize()), end='')
print()
かな[Kana] 漢字[Kanji] 交じり[Majiri] 文[Bun]
You can see benchmark result on various versions and platforms at https://github.com/miurahr/pykakasi/issues/123
PyKakasi:: Copyright (C) 2010-2021 Hiroshi Miura and contributors(see AUTHORS)
KAKASI Dictionary:: Copyright (C) 2010-2021 Hiroshi Miura and contributors(see AUTHORS)
Copyright (C) 1992 1993 1994 Hironobu Takahashi, Masahiko Sato,
Yukiyoshi Kameyama, Miki Inooka, Akihiko Sasaki, Dai Ando, Junichi Okukawa,
Katsushi Sato and Nobuhiro Yamagishi
UniDic:: Copyright (c) 2011-2021, The UniDic Consortium
All rights reserved.
Unidic is released under any of the GPL2, the LGPL2.1,
or the 3-clause BSD License. (See src/data/unidic/BSD.txt)
PyKakasi relicenses a part of the unidic with GPL3+.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
All notable changes to this project will be documented in this file.
pykakasi
, not pykakasi.exceptions
.. _Unreleased: https://github.com/miurahr/pykakasi/compare/v2.2.1...HEAD .. _v2.2.1: https://github.com/miurahr/pykakasi/compare/v2.2.0...v2.2.1 .. _v2.2.0: https://github.com/miurahr/pykakasi/compare/v2.1.1...v2.2.0 .. _v2.1.1: https://github.com/miurahr/pykakasi/compare/v2.1.0...v2.1.1 .. _v2.1.0: https://github.com/miurahr/pykakasi/compare/v2.0.8...v2.1.0 .. _v2.0.8: https://github.com/miurahr/pykakasi/compare/v2.0.7...v2.0.8 .. _v2.0.7: https://github.com/miurahr/pykakasi/compare/v2.0.6...v2.0.7 .. _v2.0.6: https://github.com/miurahr/pykakasi/compare/v2.0.5...v2.0.6 .. _v2.0.5: https://github.com/miurahr/pykakasi/compare/v2.0.4...v2.0.5 .. _v2.0.4: https://github.com/miurahr/pykakasi/compare/v2.0.3...v2.0.4 .. _v2.0.3: https://github.com/miurahr/pykakasi/compare/v2.0.2...v2.0.3 .. _v2.0.2: https://github.com/miurahr/pykakasi/compare/v2.0.1...v2.0.2 .. _v2.0.1: https://github.com/miurahr/pykakasi/compare/v2.0.0...v2.0.1 .. _v2.0.0: https://github.com/miurahr/pykakasi/compare/v2.0.0b1...v2.0.0