Python

|Build| |GitHubAction| |Coverage| |Pypi version| |PyPI downloads| |DOI|

(Russian translation_)

hotoo/pinyin <https://github.com/hotoo/pinyin>__

• Documentation: https://pypinyin.readthedocs.io/
• GitHub: https://github.com/mozillazg/python-pinyin
• License: MIT license
• PyPI: https://pypi.org/project/pypinyin
• Python version: 2.7, pypy, pypy3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12

.. contents::

• /

.. code-block:: bash

pip install pypinyin

.. code-block:: python

>>> from pypinyin import pinyin, lazy_pinyin, Style
>>> pinyin('')  # or pinyin([''])
[['zhng'], ['xn']]
>>> pinyin('', heteronym=True)  # 
[['zhng', 'zhng'], ['xn']]
>>> pinyin('', style=Style.FIRST_LETTER)  # 
[['z'], ['x']]
>>> pinyin('', style=Style.TONE2, heteronym=True)
[['zho1ng', 'zho4ng'], ['xi1n']]
>>> pinyin('', style=Style.TONE3, heteronym=True)
[['zhong1', 'zhong4'], ['xin1']]
>>> pinyin('', style=Style.BOPOMOFO)  # 
[[''], ['']]
>>> lazy_pinyin('', style=Style.WADEGILES)
['wei', "t'o", 'ma', "p'in", 'yin']
>>> lazy_pinyin('')  # 
['zhong', 'xin']
>>> lazy_pinyin('', v_to_u=True)  #  v  
['zhan', 'le']
#  5 
>>> lazy_pinyin('', style=Style.TONE3, neutral_tone_with_five=True)
['yi1', 'shang5']
#   n ho -> n ho
>>> lazy_pinyin('', style=Style.TONE2, tone_sandhi=True)
['ni2', 'ha3o']

• neutral_tone_with_five=True 5
• v ``v_to_u=True`` v
• <https://pypinyin.readthedocs.io/zh_CN/master/usage.html#handle-no-pinyin>__
• ```` en FAQ

.. code-block:: console

$ pypinyin 
yn yu

$ python -m pypinyin.tools.toneconvert to-tone 'zhong4 xin1'
zhng xn

https://pypinyin.readthedocs.io/

``_

FAQ

+++++++++++++++++++++++++++++

• <https://pypinyin.readthedocs.io/zh_CN/master/usage.html#custom-dict>__

.. code-block:: python

>> from pypinyin import load_phrases_dict, load_single_dict

>> load_phrases_dict({'': [['j'], ['z']]})  #  "" 

>> load_single_dict({ord(''): 'hi,hun'})  #  "" 

• pypinyin-dict <https://github.com/mozillazg/pypinyin-dict>__

.. code-block:: python

#  phrase-pinyin-data  cc_cedict.txt 
>>> from pypinyin_dict.phrase_pinyin_data import cc_cedict
>>> cc_cedict.load()

#  pinyin-data  kXHC1983.txt 
>>> from pypinyin_dict.pinyin_data import kxhc1983
>>> kxhc1983.load()

• :

.. code-block:: python

>>> #  jieba 
>>> # phrases_dict.py 
>>> words = list(jieba.cut('24.67'))
>>> pinyin(words)

• pypinyin-g2pW <https://github.com/mozillazg/pypinyin-g2pW>__

y, w, yu ++++++++++++++++++++++++++++++++++++++++++++

.. code-block:: python

>>> from pypinyin import Style, pinyin
>>> pinyin('', style=Style.INITIALS)
[['x'], [''], ['t']]

<http://www.moe.gov.cn/jyb_sjzl/ziliao/A19/195802/t19580201_186000.html>__ yw (yu)

INITIALS
` <http://www.moe.gov.cn/jyb_sjzl/ziliao/A19/195802/t19580201_186000.html>`__ 
yw (yu)  y  w       @hotoo

**
FIRST_LETTER**     @hotoo

: `hotoo/pinyin#57 <https://github.com/hotoo/pinyin/issues/57>`__,
`#22 <https://github.com/mozillazg/python-pinyin/pull/22>`__,
`#27 <https://github.com/mozillazg/python-pinyin/issues/27>`__,
`#44 <https://github.com/mozillazg/python-pinyin/issues/44>`__

y strict=False

.. code-block:: python

>>> from pypinyin import Style, pinyin
>>> pinyin('', style=Style.INITIALS)
[['x'], [''], ['t']]
>>> pinyin('', style=Style.INITIALS, strict=False)
[['x'], ['y'], ['t']]

strict _

+++++++++++++++++++++++++++++++++

strict=True

    g g g   m  m

```` ```` 
`#109`_ `#259`_ `#284`_ 



++++++++++++++++++++++++++++++++++++++++++++

``pypinyin.contrib.tone_convert`` 
``zhng``  ``zhong``

.. code-block:: python

   >>> from pypinyin.contrib.tone_convert import to_normal, to_tone, to_initials, to_finals
   >>> to_normal('zhng')
   'zhong'
   >>> to_tone('zhong1')
   'zhng'
   >>> to_initials('zhng')
   'zh'
   >>> to_finals('zhng')
   'ong'

``pypinyin.contrib.tone_convert`` 
` <https://pypinyin.readthedocs.io/zh_CN/master/contrib.html#tone-convert>`__ 



++++++++++++++++++++

``PYPINYIN_NO_PHRASES``
``PYPINYIN_NO_DICT_COPY`` 
` <https://pypinyin.readthedocs.io/zh_CN/master/faq.html#no-phrases>`__


FAQ 
`FAQ <https://pypinyin.readthedocs.io/zh_CN/master/faq.html>`__ 


.. _#13 : https://github.com/mozillazg/python-pinyin/issues/113
.. _strict : https://pypinyin.readthedocs.io/zh_CN/master/usage.html#strict



---------

*  `pinyin-data`_ 
*  `phrase-pinyin-data`_ 
*  ` <http://www.moe.gov.cn/jyb_sjzl/ziliao/A19/195802/t19580201_186000.html>`__ 


Related Projects
-----------------

* `hotoo/pinyin`__:  Node.js/JavaScript 
* `mozillazg/go-pinyin`__:  Go 
* `mozillazg/rust-pinyin`__:  Rust 
* `wolfgitpr/cpp-pinyin`__:  c++ 
* `wolfgitpr/csharp-pinyin`__:  c# 


__ https://github.com/hotoo/pinyin
__ https://github.com/mozillazg/go-pinyin
__ https://github.com/mozillazg/rust-pinyin
__ https://github.com/wolfgitpr/cpp-pinyin
__ https://github.com/wolfgitpr/csharp-pinyin


.. |Build| image:: https://img.shields.io/circleci/project/github/mozillazg/python-pinyin/master.svg
  :target: https://circleci.com/gh/mozillazg/python-pinyin
.. |GitHubAction| image:: https://github.com/mozillazg/python-pinyin/workflows/CI/badge.svg
  :target: https://github.com/mozillazg/python-pinyin/actions
.. |Coverage| image:: https://img.shields.io/coveralls/github/mozillazg/python-pinyin/master.svg
  :target: https://coveralls.io/github/mozillazg/python-pinyin
.. |PyPI version| image:: https://img.shields.io/pypi/v/pypinyin.svg
  :target: https://pypi.org/project/pypinyin/
.. |DOI| image:: https://zenodo.org/badge/12830126.svg
  :target: https://zenodo.org/badge/latestdoi/12830126
.. |PyPI downloads| image:: https://img.shields.io/pypi/dm/pypinyin.svg
  :target: https://pypi.org/project/pypinyin/



.. _Russian translation: https://github.com/mozillazg/python-pinyin/blob/master/README_ru.rst
.. _pinyin-data: https://github.com/mozillazg/pinyin-data
.. _phrase-pinyin-data: https://github.com/mozillazg/phrase-pinyin-data
.. _: https://pypinyin.readthedocs.io/zh_CN/develop/develop.html
.. _#109: https://github.com/mozillazg/python-pinyin/issues/109
.. _#259: https://github.com/mozillazg/python-pinyin/issues/259
.. _#284: https://github.com/mozillazg/python-pinyin/issues/284