semvec/pypi-packages huggingface dataset:
ypinyin 0.5.6
translate chinese hanzi to pinyin by python
License: BSD
Keywords: pinyin

ypinyin
==========

.. image:: https://img.shields.io/travis/liuguangyuan/ypinyin.svg
    :target: https://travis-ci.org/liuguangyuan/ypinyin

.. image:: https://img.shields.io/pypi/v/ypinyin.svg
    :target: https://pypi.python.org/pypi/ypinyin/

.. image:: https://img.shields.io/pypi/dm/ypinyin.svg
    :target: https://pypi.python.org/pypi/ypinyin/

translate chinese hanzi to pinyin by python, inspired by flyerhzm’s
`chinese\_pinyin`_ gem

Install
----------

::

    pip install ypinyin


Usage
-----

::

    >>> from ypinyin import Pinyin
    >>> p = Pinyin()
    >>> # default splitter is `-`
    >>> p.get_pinyin(u"上海")
    'shang-hai'
    >>> # show tone marks
    >>> p.get_pinyin(u"上海", show_tone_marks=True)
    'shàng-hǎi'
    >>> # remove splitter
    >>> p.get_pinyin(u"上海", '')
    'shanghai'
    >>> # set splitter as whitespace
    >>> p.get_pinyin(u"上海", ' ')
    'shang hai'
    >>> p.get_initial(u"上")
    'S'
    >>> p.get_initials(u"上海")
    'S-H'
    >>> p.get_initials(u"上海", u'')
    'SH'
    >>> p.get_initials(u"上海", u' ')
    'S H'
    
    如果方法中传入变量，那么直接加前缀是不可以了。而是要将变量转为utf-8编码：
    >>> wordvalue = '中国'
    >>> wordvalue= unicode(wordvalue,'utf-8')
    >>> s = p.get_initials(wordvalue, u'').lower()
    'zg'
    

请输入utf8编码汉字



.. _chinese\_pinyin: https://github.com/flyerhzm/chinese_pinyin


Changelog
=========


0.5.5 - Feb. 28, 2016
----------------------
- add a new staticmethod which can convert pinyin to upper, lower or capitalize.
  https://github.com/liuguangyuan/ypinyin/pull/28

- Removed extraneous "!" being appended to non 'a' vowel replacements when show_tone_marks=True; also added simple unitest.main() for non-nose users
  https://github.com/liuguangyuan/ypinyin/pull/30


0.5.4 - Dec. 14, 2015
----------------------

- replace open() calls with io.open() for Python 3 compatibility,
  fix `UnicodeDecodeError`
- change \u730E 猎 to LIE4
- improve readme


0.5.3 - Dec. 25, 2014
----------------------

- adjust default pinyin for character '什' and '么', 什么 => 'shén-me'


0.5.2 - Jul. 6, 2014
----------------------

- 修复一些常用字的拼音标注

0.4.9 - Oct. 25, 2013
----------------------

- change README and get_initials; add get_initial
  [tangsty]


0.4.8 - Jun. 16, 2013
----------------------

- change README and get_initials; add get_initial
  [tangsty]

- add download status image to README.rst
  [liuguangyuan]

- add travis status image to README.rst
  [liuguangyuan]

- add .travis.yml
  [liuguangyuan]

- 添加测试
  [liuguangyuan]

- 解决翻译中英文混合句子问题
  [liuguangyuan]