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

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page