Metadata-Version: 2.4
Name: pyenglish2pinyin
Version: 0.1.0
Summary: Convert English words to numbered Pinyin using CMUdict IPA.
Author: Davy Chen
License-Expression: MIT
Project-URL: Homepage, https://coderhome.com/
Project-URL: Repository, https://github.com/davychxn/ENGLISH2PINYIN
Keywords: english,pinyin,ipa,cmudict,pronunciation
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# pyenglish2pinyin

Python package to convert English words into numbered Pinyin using CMUdict-style IPA.

## Install

```bash
pip install pyenglish2pinyin
```

## Usage

```python
from english2pinyin import english2ipa, english2pinyin, ipa2pinyin

print(english2ipa("application"))
# AE2 P L AH0 K EY1 SH AH0 N

print(english2pinyin("application"))
# ai4 po5 la5 kui1 sha5 en5

print(ipa2pinyin("S IH0 K Y UH1 R IH0 NG"))
# xi5 ke5 yu1 rui5 eng5
```

## API

- `english2ipa(word, dict_path=None)` -> `str | None`
- `english2pinyin(word, dict_path=None, throw_if_missing=False)` -> `str`
- `ipa2pinyin(ipa_text)` -> `str`

## Development

```bash
pip install -e .[dev]
pytest
```
