Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(1.4 MB) Copy SHA256 Hash SHA256
Wheel 2.7 May 23, 2016
(1.4 MB) Copy SHA256 Hash SHA256
Source None May 23, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting