Skip to main content

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]

Metadata

Release files for xpinyin 0.7.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xpinyin 0.7.7
File Size Uploaded
xpinyin-0.7.7.tar.gz 134.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for xpinyin 0.7.7
File Interpreter ABI Platform
xpinyin-0.7.7-py3-none-any.whl Python 3 none any Details

Total release size: 263.7 kB

Release files / xpinyin-0.7.7.tar.gz

Download URL xpinyin-0.7.7.tar.gz
Size 134.0 kB
Tags Source
SHA-256 checksum
How to use checksums
89a1f3f12c7119b4526b93360a74fbe48ee24847481a4bab3b4fee8f4536079d
BLAKE2b-256 checksum
How to use checksums
6e3e41397274f9447ba29a947778b669b6f21717839ed164eba6b68cd168e705
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.13

Release files / xpinyin-0.7.7-py3-none-any.whl

Download URL xpinyin-0.7.7-py3-none-any.whl
Size 129.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1317a0140b704e03e5f368c2dc7618887a2fc45cdc288b6d648e2ebabf571f0e
BLAKE2b-256 checksum
How to use checksums
82bdf7865b810ca7cc82fa566ec224786f674aab878d89866370ea7a20063b4c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.13

Release history Release notifications | RSS feed

This release

0.7.7 This release

2 release files

0.7.6

2 release files

0.7.5

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.7

2 release files

0.5.6

1 release file

0.5.5

1 release file

0.5.4

1 release file

0.5.3

1 release file

0.5.2

2 release files

0.5.1

2 release files

0.5.0

1 release file

0.4.9

1 release file

0.4.8

1 release file

0.4.7

1 release file

0.4.6

1 release file

0.4.5

1 release file

0.4.4

1 release file

0.4.3

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4

1 release file

0.3

1 release file

0.2

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page