Metadata-Version: 2.1
Name: moore-num
Version: 0.1.1
Summary: A library to convert numbers to Mooré text and vice versa
Home-page: https://github.com/ohamjoseph/moore_num.git
Author: Hamed
Author-email: hamed.ouily@gmail.com
Keywords: moore,language,mossi,numbers,conversion,burkina faso
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# moore_num

A Python library for converting numbers to Mooré (Mossi) language text and vice versa.

## Features

- **Number to Mooré Text**: Convert integers to their textual representation in Mooré.
- **Mooré Text to Number**: Parse Mooré number phrases back into integers.
- **Money Mode**: Special scaling factor (x5) for currency calculations common in Burkina Faso.
- **Support for Large Numbers**: Handles units, tens, hundreds, thousands, millions, and billions.

## Installation

```bash
pip install moore_num
```

## Usage

### Forward Conversion (Number to Text)

```python
from moore_num import convert_to_text

# Standard conversion
print(convert_to_text(125)) 
# Output: "Koabga la pisi la a nu"

# Money mode (5 CFA = 1 unit in common counting)
print(convert_to_text(500, is_money=True))
# Output: "Koabga"
```

### Reverse Conversion (Text to Number)

```python
from moore_num import text_to_num

# Standard reverse
print(text_to_num("Piig la a yii"))
# Output: 12

# Money mode reverse
print(text_to_num("Koabga", is_money=True))
# Output: 500
```

### Command Line Interface

```bash
# Forward
num2moore 125

# Reverse
num2moore "Piig la a yii" --reverse

# Money mode
num2moore 500 --money
```

## License

MIT
