toword 0.0.1

Convert numbers into English words easily

📘 number_to_words

Convert integers into readable English words – simple, fast, and dependency-free.

---

Overview

number_to_words is a lightweight Python package that converts numbers into English words. It supports values from 0 up to billions, formatted just like humans speak.

✔ No dependencies ✔ Fast and accurate ✔ Easy to import and use ✔ Clean modular implementation

---

Installation

Install using pip:

pip install number_to_words

---

Usage

Basic example

import number_to_words as nw

print(nw.num(45))        # forty five
print(nw.num(2024))      # two thousand twenty four
print(nw.num(987654321)) # nine hundred eighty seven million six hundred fifty four thousand three hundred twenty one

Importing the function directly

from number_to_words import num

print(num(123))  # one hundred twenty three

---

Supported Ranges

Range	Example Output
0–13	zero → thirteen
14–19	fourteen → nineteen
20–99	twenty one, ninety nine
100–999	one hundred fifty two
1,000–999,999	twelve thousand three hundred ten
1,000,000–999,999,999	ninety eight million ...
1,000,000,000+	up to billions

---

Project Structure

number_to_words/
    __init__.py
    main.py
    ds.py
    tens.py
    hundreds.py
    thousands.py
    millions.py
    billions.py

Each module handles one specific number range, making the code easy to maintain and extend.

---

API Reference

num(x: int) -> str

Convert any integer to its English representation.

Example:

from number_to_words import num
num(1200305)

Output:

one million two hundred thousand three hundred five

---

Contributing

Contributions, issues, and pull requests are welcome.

If you find this package useful, please consider giving the repository a ⭐ on GitHub!

---

Contact

Author: Saumya Kanti Sarma Email: [e-mail] Instagram: saumya__sarma

Feel free to reach out for collaboration, questions, or feedback.