{"categories":[{"label":"Python Modules","url":"https://skillfed.io/packages/category/software-development-libraries-python-modules/22"}],"enrichment":{"capability":"Converts Chinese characters (hanzi) to their phonetic romanization (pinyin), with support for tone marks, initial consonants, and multiple character readings.","skillfed_tags":["chinese-nlp","romanization","text-processing"],"use_cases":["Building search indexes that allow users to find Chinese text by typing pinyin instead of characters","Generating phonetic guides or furigana-style annotations for Chinese text in educational applications","Implementing text-to-speech systems that need to convert hanzi to romanized pronunciation","Sorting or organizing Chinese text alphabetically by pinyin for catalogs or directories","Disambiguating characters with multiple pronunciations in natural language processing pipelines"],"what_it_does":"xpinyin is a Python library that translates Chinese characters into pinyin (the standard romanization system for Mandarin). It provides methods to extract the full phonetic spelling of characters, their initial consonants, and tone information in multiple formats\u2014tone marks, tone numbers, or unmarked. The library also supports generating all possible pinyin combinations for characters with multiple readings, which is useful for disambiguation in mixed-reading contexts.\n\nThe package has no external dependencies and installs cleanly on modern Python versions. It's designed for developers building Chinese text processing pipelines, search systems, or applications that need to work with phonetic representations of Chinese text. The API is straightforward: instantiate a Pinyin object and call methods like get_pinyin(), get_initial(), or get_initials() with optional parameters to control output format.","worth_installing":"Yes, if you need reliable Chinese-to-pinyin conversion. The package is stable, dependency-free, and covers the core use cases well. The aging maintenance status (438 days since last release) is not a blocker\u2014the code is mature and the repository remains active\u2014but monitor it if you depend on ongoing feature development or rapid bug fixes."},"id":"xpinyin","links":{"html":"https://skillfed.io/packages/xpinyin","md":"https://skillfed.io/packages/xpinyin.md","pypi":"https://pypi.org/project/xpinyin/"},"maintenance":{"status":"aging"},"meta":{"latest_release":"2025-06-02","license_spdx":null,"license_treatment":"permissive","name":"xpinyin","python_support":"unspecified","summary":"Translate Chinese hanzi to pinyin (\u62fc\u97f3) by Python, \u6c49\u5b57\u8f6c\u62fc\u97f3"},"popularity":{"monthly_downloads":73649,"position":14955,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.7.7"}