Metadata-Version: 2.4
Name: numly
Version: 0.1.0
Summary: Convert numbers across numeral systems — Roman, Chinese, Greek, Egyptian, Arabic-Indic and more.
Home-page: https://github.com/TheMadrasTechie/numly
Author: TheMadrasTechie
Author-email: you@example.com
Keywords: numerals,roman,chinese,greek,egyptian,arabic-indic,number,converter
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-python
Dynamic: summary

<p align="center">
  <img src="numly_rounded_square.svg" alt="numly logo" width="120" height="120"/>
</p>

<h1 align="center">numly</h1>

<p align="center">
  <img src="https://img.shields.io/pypi/v/numly" alt="PyPI version"/>
  <img src="https://img.shields.io/pypi/pyversions/numly" alt="Python versions"/>
  <img src="https://img.shields.io/github/license/yourusername/numly" alt="License"/>
</p>

<p align="center">
  A Python library to work with numbers across formats — decimal, roman, words, binary, hex, and more.
</p>

---

## Installation

```bash
pip install numly
```

---

## Quick Start

```python
import numly

# Convert to Roman numerals
numly.to_roman(2024)        # → 'MMXXIV'

# Convert to words
numly.to_words(42)          # → 'forty-two'

# Convert to binary
numly.to_binary(255)        # → '11111111'

# Convert to hex
numly.to_hex(255)           # → 'FF'
```

---

## Features

- 🔢 Decimal → Roman numerals
- 🔤 Decimal → Words (English)
- 💻 Decimal → Binary / Octal / Hex
- 🔁 Reverse conversions (Roman → Decimal, etc.)
- 🌍 Locale-aware number formatting *(coming soon)*

---

## API Reference

| Function | Input | Output |
|---|---|---|
| `to_roman(n)` | `int` | `str` — e.g. `'XIV'` |
| `from_roman(s)` | `str` | `int` — e.g. `14` |
| `to_words(n)` | `int` | `str` — e.g. `'forty-two'` |
| `to_binary(n)` | `int` | `str` — e.g. `'1110'` |
| `to_octal(n)` | `int` | `str` — e.g. `'16'` |
| `to_hex(n)` | `int` | `str` — e.g. `'E'` |

---

## Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

```bash
git clone https://github.com/yourusername/numly.git
cd numly
pip install -e .
```

---

## License

MIT License © 2026 TheMadrasTechie
