Skip to main content

number-to-word is a Python library for converting numbers into their written English or Arabic word equivalents.

Project description

number-to-word

number-to-word is a Python library for converting numbers into their written English or Arabic word equivalents. This library is particularly useful for financial applications, where there is a need to convert numeric values into written text. It also supports currency names.

Features

  • Convert numbers to written words in English or Arabic.
  • Add currency names to the converted results.
  • Lightweight and easy to integrate.

Installation

You can install number-to-word using pip:

pip install number-to-word

Usage

Here's a simple example of how to use number-to-word:

from numbertoword import NumberToWord

# Convert a number to words in English
print(NumberToWord.to_word(123.5, 'SYP', "English"))  # Output: One Hundred Twenty Three Syrian Pounds and Fifty Piasters only.

# Convert a number to words in Arabic
print(NumberToWord.to_word(123.5, 'SYP', "Arabic"))  # Output: فقط مائة و ثلاثة و عشرون ليرة سورية و خمسون قرشاً لا غير.

Contributing

Contributions are welcome! If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.

Licensing

This project is licensed under MIT License.

Contact

For any queries or feedback, please reach out to Adel Khayata.

Acknowledgements

  • Thanks to all the contributors who have helped to shape number-to-word.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

number-to-word-1.1.tar.gz (8.1 kB view hashes)

Uploaded Source

Built Distribution

number_to_word-1.1-py3-none-any.whl (8.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page