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.7.tar.gz (134.0 kB view details)

Uploaded Source

Built Distribution

xpinyin-0.7.7-py3-none-any.whl (129.8 kB view details)

Uploaded Python 3

File details

Details for the file xpinyin-0.7.7.tar.gz.

File metadata

  • Download URL: xpinyin-0.7.7.tar.gz
  • Upload date:
  • Size: 134.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.13

File hashes

Hashes for xpinyin-0.7.7.tar.gz
Algorithm Hash digest
SHA256 89a1f3f12c7119b4526b93360a74fbe48ee24847481a4bab3b4fee8f4536079d
MD5 eee334d512997b515352f66994c6a1e2
BLAKE2b-256 6e3e41397274f9447ba29a947778b669b6f21717839ed164eba6b68cd168e705

See more details on using hashes here.

File details

Details for the file xpinyin-0.7.7-py3-none-any.whl.

File metadata

  • Download URL: xpinyin-0.7.7-py3-none-any.whl
  • Upload date:
  • Size: 129.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.13

File hashes

Hashes for xpinyin-0.7.7-py3-none-any.whl
Algorithm Hash digest
SHA256 1317a0140b704e03e5f368c2dc7618887a2fc45cdc288b6d648e2ebabf571f0e
MD5 25788b1517946c4072f59b6af3b507f4
BLAKE2b-256 82bdf7865b810ca7cc82fa566ec224786f674aab878d89866370ea7a20063b4c

See more details on using hashes here.

Supported by

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