Skip to main content

Translate Chinese hanzi to pinyin (拼音) by Python, 汉字转拼音

Project description

xpinyin

Translate Chinese hanzi to pinyin (拼音) by Python, 汉字转拼音

https://github.com/lxneng/xpinyin/workflows/Tests/badge.svg https://img.shields.io/travis/lxneng/xpinyin.svg https://img.shields.io/pypi/v/xpinyin.svg https://img.shields.io/pypi/dm/xpinyin.svg

Install

Python version >= 3.6

pip install -U xpinyin

Python version < 3.6

pip install xpinyin==0.5.7

Usage

>>> from xpinyin import Pinyin
>>> p = Pinyin()
>>> # default splitter is `-`
>>> p.get_pinyin("上海")
'shang-hai'
>>> # show tone marks
>>> p.get_pinyin("上海", tone_marks='marks')
'shàng-hǎi'
>>> p.get_pinyin("上海", tone_marks='numbers')
>>> 'shang4-hai3'
>>> # remove splitter
>>> p.get_pinyin("上海", '')
'shanghai'
>>> # set splitter as whitespace
>>> p.get_pinyin("上海", ' ')
'shang hai'
>>> p.get_initial("上")
'S'
>>> p.get_initials("上海")
'S-H'
>>> p.get_initials("上海", '')
'SH'
>>> p.get_initials("上海", ' ')
'S H'
>>> # get_initials with retroflex, #39
>>> p.get_initials("上海", splitter='-', with_retroflex=True)
'SH-H'
>>> # New in version 0.7.0, get combinations of the multiple readings of the characters
>>> p.get_pinyins('模型', splitter=' ', tone_marks='marks')
['mó xíng', 'mú xíng']
>>> p.get_pinyins('模样', splitter=' ', tone_marks='marks')
['mó yáng', 'mó yàng', 'mó xiàng', 'mú yáng', 'mú yàng', 'mú xiàng']

Changelog

0.7.6 - Dec. 21, 2020

0.7.5 - Dec. 21, 2020

  • fix py2 compatible versions

0.7.4 - Dec. 15, 2020

  • update install doc in readme

0.7.3 - Dec. 14, 2020

  • fix github actions status icon

0.7.2 - Dec. 14, 2020

0.7.0 - Dec. 13, 2020

0.6.0 - Dec. 11, 2020

0.5.7 - Jun. 28, 2020

  • fixes #36, #37

0.5.6 - Oct. 15, 2018

0.5.5 - Feb. 28, 2016

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 [lxneng]

  • add travis status image to README.rst [lxneng]

  • add .travis.yml [lxneng]

  • 添加测试 [lxneng]

  • 解决翻译中英文混合句子问题 [lxneng]

Project details


Download files

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

Source Distribution

xpinyin-0.7.6.tar.gz (131.7 kB view hashes)

Uploaded Source

Built Distribution

xpinyin-0.7.6-py3-none-any.whl (129.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page