xpinyin

translate chinese hanzi to pinyin by python

Github stars Tracking Chart

xpinyin

.. image:: https://img.shields.io/travis/lxneng/xpinyin.svg
:target: https://travis-ci.org/lxneng/xpinyin

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

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

translate chinese hanzi to pinyin by python, inspired by flyerhzm’s
chinese\_pinyin_ gem

Install

::

pip install xpinyin

Usage

::

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

Main metrics

Overview
Name With Ownerlxneng/xpinyin
Primary LanguagePython
Program languagePython (Language Count: 1)
Platform
License:MIT License
所有者活动
Created At2010-05-20 13:28:54
Pushed At2025-06-02 04:33:20
Last Commit At2025-06-02 12:33:15
Release Count0
用户参与
Stargazers Count827
Watchers Count44
Fork Count177
Commits Count129
Has Issues Enabled
Issues Count40
Issue Open Count8
Pull Requests Count19
Pull Requests Open Count0
Pull Requests Close Count4
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private