Metadata-Version: 2.4
Name: word-number-converter
Version: 0.1.0
Summary: A multi-language library to convert numbers to words and words to numbers.
Author-email: Ricardo <ricardo.devstudio@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/mricardo888/WordNumberConverter
Project-URL: Issues, https://github.com/mricardo888/WordNumberConverter/issues
Keywords: number,word,converter,nlp,chinese,arabic,spanish,french,german
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Natural Language :: English
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Natural Language :: Chinese (Traditional)
Classifier: Natural Language :: Arabic
Classifier: Natural Language :: Spanish
Classifier: Natural Language :: French
Classifier: Natural Language :: German
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Word Number Converter

A lightweight, multi-language Python library for converting **numbers to words** and **words back to numbers**.  
It supports multiple human languages, Chinese numeral systems, and Roman numerals, all through a simple API.

---

## ✨ Features

- Convert integers to words in multiple languages
- Convert words back to integers (where supported)
- Chinese number systems:
  - Simplified
  - Traditional
  - Financial
- Roman numeral conversion
- Handles negative numbers
- No external dependencies

---

## 🌍 Supported Languages

### Number → Words
- English (`en`)
- Chinese (`zh`)
- Spanish (`es`)
- French (`fr`)
- German (`de`)
- Swahili (`sw`)
- Japanese (`ja`)
- Arabic (`ar`)
- Roman numerals

### Words → Number
- English (`en`)
- Chinese (`zh`)
- Roman numerals (`roman`)

> ⚠️ Reverse conversion is not yet implemented for all languages.

---

## 📦 Installation

```bash
pip install word-number-converter
````

---

## 🚀 Quick Start

```python
from word_number_converter import WordNumberConverter

converter = WordNumberConverter()
```

### Number to Words

```python
converter.number_to_words(123)
# "one hundred twenty-three"

converter.number_to_words(456, lang="es")
# "cuatrocientos cincuenta y seis"

converter.number_to_words(789, lang="fr")
# "sept cent quatre-vingt-neuf"

converter.number_to_words(2024, lang="zh", system="simplified")
# "二千零二十四"

converter.number_to_words(-15, lang="de")
# "minus fünfzehn"
```

### Words to Number

```python
converter.words_to_number("one hundred twenty three")
# 123

converter.words_to_number("一百二十三", lang="zh")
# 123

converter.words_to_number("MCMXCIV", lang="roman")
# 1994
```

### Roman Numerals

```python
converter.number_to_roman(1994)
# "MCMXCIV"

converter.roman_to_number("XLII")
# 42
```

---

## 🀄 Chinese Number Systems

```python
converter.number_to_words(1024, lang="zh", system="simplified")
# 一千零二十四

converter.number_to_words(1024, lang="zh", system="traditional")
# 一千零二十四

converter.number_to_words(1024, lang="zh", system="financial")
# 壹仟零贰拾肆
```

Supported systems:

* `simplified`
* `traditional`
* `financial`

---

## 🧠 Design Notes

* Focused on correctness and readability over linguistic edge cases
* Designed for NLP preprocessing, localization, and educational use
* No third-party dependencies
* Python ≥ 3.7

---

## 📄 License

[MIT License](LICENSE)

---

## 👤 Author

**Ricardo**
📧 [ricardo.devstudio@gmail.com](mailto:ricardo.devstudio@gmail.com)

---

## 🔗 Links

* Homepage: [https://github.com/mricardo888/WordNumberConverter](https://github.com/mricardo888/WordNumberConverter)
* Issues: [https://github.com/mricardo888/WordNumberConverter/issues](https://github.com/mricardo888/WordNumberConverter/issues)
