📘 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

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: work.saumyasarma@gmail.com Instagram: saumya__sarma

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