https://github.com/ikegami-yukino/jaconv

Pure-Python Japanese character interconverter for Hiragana, Katakana, Hankaku, and Zenkaku
https://github.com/ikegami-yukino/jaconv

character-converter japanese-kana japanese-language julius preprocessing pure-python text-processing transliteration

Last synced: 17 days ago
JSON representation

Pure-Python Japanese character interconverter for Hiragana, Katakana, Hankaku, and Zenkaku

• Host: GitHub
• URL: https://github.com/ikegami-yukino/jaconv
• Owner: ikegami-yukino
• License: mit
• Created: 2016-04-02T06:40:10.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2025-01-12T14:44:03.000Z (4 months ago)
• Last Synced: 2025-04-12T02:58:22.940Z (17 days ago)
• Topics: character-converter, japanese-kana, japanese-language, julius, preprocessing, pure-python, text-processing, transliteration
• Language: Python
• Homepage: https://ikegami-yukino.github.io/jaconv/jaconv.html
• Size: 537 KB
• Stars: 325
• Watchers: 10
• Forks: 31
• Open Issues: 7
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
jaconv

==========

|coveralls| |pyversion| |version| |license| |download|

jaconv (Japanese Converter) is interconverter for Hiragana, Katakana, Hankaku (half-width character) and Zenkaku (full-width character)

`Japanese README `_ is available.

INSTALLATION

==============

::

 $ pip install jaconv

USAGE

============

See also `document `_

.. code:: python

  import jaconv

  # Hiragana to Katakana

  jaconv.hira2kata('ともえまみ')

  # => 'トモエマミ'

  # Hiragana to half-width Katakana

  jaconv.hira2hkata('ともえまみ')

  # => 'ﾄﾓｴﾏﾐ'

  # Katakana to Hiragana

  jaconv.kata2hira('巴マミ')

  # => '巴まみ'

  # half-width character to full-width character

  # default parameters are followings: kana=True, ascii=False, digit=False

  jaconv.h2z('ﾃｨﾛ･ﾌｨﾅｰﾚ')

  # => 'ティロ・フィナーレ'

  # half-width character to full-width character

  # but only ascii characters

  jaconv.h2z('abc', kana=False, ascii=True, digit=False)

  # => 'ａｂｃ'

  # half-width character to full-width character

  # but only digit characters

  jaconv.h2z('123', kana=False, ascii=False, digit=True)

  # => '１２３'

  # half-width character to full-width character

  # except half-width Katakana

  jaconv.h2z('ｱabc123', kana=False, digit=True, ascii=True)

  # => 'ｱａｂｃ１２３'

  # an alias of h2z

  jaconv.hankaku2zenkaku('ﾃｨﾛ･ﾌｨﾅｰﾚabc123')

  # => 'ティロ・フィナーレabc123'

  # full-width character to half-width character

  # default parameters are followings: kana=True, ascii=False, digit=False

  jaconv.z2h('ティロ・フィナーレ')

  # => 'ﾃｨﾛ・ﾌｨﾅｰﾚ'

  # full-width character to half-width character

  # but only ascii characters

  jaconv.z2h('ａｂｃ', kana=False, ascii=True, digit=False)

  # => 'abc'

  # full-width character to half-width character

  # but only digit characters

  jaconv.z2h('１２３', kana=False, ascii=False, digit=True)

  # => '123'

  # full-width character to half-width character

  # except full-width Katakana

  jaconv.z2h('アａｂｃ１２３', kana=False, digit=True, ascii=True)

  # => 'アabc123'

  # an alias of z2h

  jaconv.zenkaku2hankaku('ティロ・フィナーレａｂｃ１２３')

  # => 'ﾃｨﾛ･ﾌｨﾅｰﾚａｂｃ１２３'

  # normalize

  jaconv.normalize('ティロ･フィナ〜レ', 'NFKC')

  # => 'ティロ・フィナーレ'

  # Hiragana to alphabet

  jaconv.kana2alphabet('じゃぱん')

  # => 'japan'

  # Alphabet to Hiragana

  jaconv.alphabet2kana('japan')

  # => 'じゃぱん'

  # Katakana to Alphabet

  jaconv.kata2alphabet('ケツイ')

  # => 'ketsui'

  # Alphabet to Katakana

  jaconv.alphabet2kata('namba')

  # => 'ナンバ'

  # Hiragana to Julius's phoneme format

  jaconv.hiragana2julius('てんきすごくいいいいいい')

  # => 't e N k i s u g o k u i:'

NOTE

============

jaconv.normalize method expand unicodedata.normalize for Japanese language processing.

.. code::

    '〜' => 'ー'

    '～' => 'ー'

    "’" => "'"

    '”'=> '"'

    '“' => '``'

    '―' => '-'

    '‐' => '-'

    '˗' => '-'

    '֊' => '-'

    '‐' => '-'

    '‑' => '-'

    '‒' => '-'

    '–' => '-'

    '⁃' => '-'

    '⁻' => '-'

    '₋' => '-'

    '−' => '-'

    '﹣' => 'ー'

    '－' => 'ー'

    '—' => 'ー'

    '―' => 'ー'

    '━' => 'ー'

    '─' => 'ー'

.. |coveralls| image:: https://coveralls.io/repos/ikegami-yukino/jaconv/badge.svg?branch=master&service=github

    :target: https://coveralls.io/github/ikegami-yukino/jaconv?branch=master

    :alt: coveralls.io

.. |pyversion| image:: https://img.shields.io/pypi/pyversions/jaconv.svg

.. |version| image:: https://img.shields.io/pypi/v/jaconv.svg

    :target: http://pypi.python.org/pypi/jaconv/

    :alt: latest version

.. |license| image:: https://img.shields.io/pypi/l/jaconv.svg

    :target: http://pypi.python.org/pypi/jaconv/

    :alt: license

.. |download| image:: https://static.pepy.tech/personalized-badge/neologdn?period=total&units=international_system&left_color=black&right_color=blue&left_text=Downloads

    :target: https://pepy.tech/project/neologdn

    :alt: download