Skip to main content

Identification and conversion functions for Chinese text processing

Project description

Dragon Mapper is a Python library that provides identification and conversion functions for Chinese text processing.


  • Convert between Chinese characters, Pinyin, Zhuyin, and the International Phonetic Alphabet.

  • Identify a string as Traditional or Simplified Chinese, Pinyin, Zhuyin, or the International Phonetic Alphabet.

>>> s = '我是一个美国人。'
>>> dragonmapper.hanzi.is_simplified(s)
>>> dragonmapper.hanzi.to_pinyin(s)
>>> dragonmapper.hanzi.to_pinyin(s, all_readings=True)
>>> s = 'Wǒ shì yīgè měiguórén.'
>>> dragonmapper.transcriptions.is_pinyin(s)
>>> dragonmapper.transcriptions.pinyin_to_zhuyin(s)
'ㄨㄛˇ ㄕˋ ㄧ ㄍㄜˋ ㄇㄟˇ ㄍㄨㄛˊ ㄖㄣˊ.'
>>> dragonmapper.transcriptions.pinyin_to_ipa(s)
'wɔ˧˩˧ ʂɨ˥˩ i˥ kɤ˥˩ meɪ˧˩˧ kwɔ˧˥ ʐən˧˥.'

Getting Started

Change Log

0.2.6 (2016-05-23)

  • Fixes reading for 女. Fixes #10.

  • Add a note about Unicode string for Python 2 users.

  • Bumps required hanzidentifier version.

  • Fix umlaut on “l” consonant. Fixes #14.

0.2.5 (2015-08-06)

  • Fixes #9. Uses in with UTF-8 encoding.

0.2.4 (2015-04-08)

  • Fixes #8. Adds re.UNICODE to transcription conversion.

  • Fixes misformatted readings for certain characters.

  • Fixes #7. Fixes incorrect Unihan Database readings for the ‘ou’ vowel combinations.

0.2.3 (2014-04-28)

  • Fixes #6. Adds -r suffix syllable to transcription mapping data.

0.2.2 (2014-04-28)

  • Fixes a capitalization bug related to #5.

0.2.1 (2014-04-28)

  • Reformats README.rst.

  • Renames change log file to *.rst.

  • Adds authors and contributing files.

  • Sets up Travis CI.

  • Adds version to

  • Fixes #5. Make accented_to_numbered() add apostrophes when needed.

  • Fixes #4. Fixes numbered_to_accented() handling of 'v' vowel.

  • Fixes #3. Changes IndexError exception handlers to KeyError.

  • Fixes #2. Fixes accented_to_numbered() with uppercase accented vowel.

0.2.0 (2014-04-14)

  • Fixes typo in is_pinyin.

  • Adds is_pinyin_compatible() and is_zhuyin_compatible() functions.

  • Removes code for identifying Hanzi and incorporates Hanzi Identifier library.

  • Removes Sphinx viewcode extension.

  • Adds Python 3.4 environment to tox configuration.

  • Fixes typo in Fixes #1.

0.1.0 (2014-02-17)

  • Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dragonmapper-0.2.6.tar.gz (1.4 MB view hashes)

Uploaded source

Built Distribution

dragonmapper-0.2.6-py2.py3-none-any.whl (1.4 MB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page