Rewrite lxneng's xpinyin by cython since by commit 3599c101f659bb7cfbc7e5c5c5684206e4fab5f9 <https://github.com/lxneng/xpinyin/commit/3599c101f659bb7cfbc7e5c5c5684206e4fab5f9>.

The interfaces are completely consistent and can be seamlessly switched with xpinyin;

pip install cpinyin 

Replace xpinyin.Pinyin with cpinyin.Pinyin

>>> import cpinyin >>> cpinyin.install() >>> from xpinyin import Pinyin >>> p = Pinyin() >>> p.get_pinyin(u"上海") 'shang-hai' 

Consistent with the xpinyin Api.

>>> from cpinyin import Pinyin >>> p = Pinyin() >>> # default splitter is `-` >>> p.get_pinyin(u"上海") 'shang-hai' >>> # show tone marks >>> p.get_pinyin(u"上海", tone_marks=u'marks') 'shàng-hǎi' >>> p.get_pinyin(u"上海", tone_marks=u'numbers') >>> 'shang4-hai3' >>> # remove splitter >>> p.get_pinyin(u"上海", u'') 'shanghai' >>> # set splitter as whitespace >>> p.get_pinyin(u"上海", 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' 

Please enter Chinese characters encoding by utf8.

>>> wordvalue = '中国' >>> wordvalue= unicode(wordvalue, 'utf-8') >>> s = p.get_initials(wordvalue, u'').lower() 'zg'