Metadata-Version: 2.1
Name: dragonmapper
Version: 0.2.6
Summary: Identification and conversion functions for Chinese text processing
Home-page: https://github.com/tsroten/dragonmapper
Author: Thomas Roten
Author-email: thomas@roten.us
Keywords: chinese,mandarin,transcription,pinyin,zhuyin,ipa,convert,bopomofo,hanzi,characters,readings
Platform: any
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Text Processing :: Linguistic
License-File: LICENSE.txt
License-File: AUTHORS.rst

=============
Dragon Mapper
=============

.. image:: https://badge.fury.io/py/dragonmapper.png
    :target: http://badge.fury.io/py/dragonmapper
    
.. image:: https://travis-ci.org/tsroten/dragonmapper.png?branch=develop
        :target: https://travis-ci.org/tsroten/dragonmapper

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

* Documentation: http://dragonmapper.rtfd.org
* GitHub: https://github.com/tsroten/dragonmapper
* Free software: MIT license

Features
--------

* 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.

.. code:: python

    >>> s = '我是一个美国人。'
    >>> dragonmapper.hanzi.is_simplified(s)
    True
    >>> dragonmapper.hanzi.to_pinyin(s)
    'wǒshìyīgèměiguórén。'
    >>> dragonmapper.hanzi.to_pinyin(s, all_readings=True)
    '[wǒ][shì/shi/tí][yī][gè/ge/gě/gàn][měi][guó][rén/ren]。'

.. code:: python

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

Getting Started
---------------
* `Install Dragon Mapper <http://dragonmapper.readthedocs.org/en/latest/installation.html>`_
* Read `Dragon Mapper's tutorial <http://dragonmapper.readthedocs.org/en/latest/tutorial.html>`_
* Report bugs and ask questions via `GitHub Issues <https://github.com/tsroten/dragonmapper>`_
* Refer to the `API documentation <http://dragonmapper.readthedocs.org/en/latest/api.html>`_ when you need more technical information
* `Contribute <http://dragonmapper.readthedocs.org/en/latest/contributing.html>`_ documentation, code, or feedback




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 io.open() in setup.py 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 ``__init__.py``.
* 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 setup.py. Fixes #1.

0.1.0 (2014-02-17)
++++++++++++++++++

* Initial release.
