Skip to main content

A currency formatter for many currencies

Project description

Currencies Formatter

The Currencies Formatter Library (or currencies lib) is a Python library designed to simplify the formatting of monetary values for various currencies. It supports a wide range of currencies and provides options for custom formatting. Whether you need to display values with currency symbols or abbreviate large numbers, this library offers a straightforward solution.

Features

  • Format monetary values for a variety of currencies.
  • Customizable formatting options for currency symbols and decimal places.
  • Supports both standard and custom currency symbols.
  • Allows conversion of values to percentage format.
  • Utility functions for abbreviating units and detecting currency symbols.

Installing

You can install this library with:

$ pip install currencies-lib

Example of use

from currencies_lib import BRL

value = 1250.50
result = BRL(value, currency_symbol=True)
print(result)
#> "R$ 1.250,50"

or

from currencies_lib import *

value = 1250.50
result = Currency_Formatter.EUR(value, currency_symbol=True, eur_sign=True)
print(result)
#> "€ 1.250,50"

Note: Direct imports from the currencies_lib module are not recommended. Use from currencies_lib import ... to access specific formatters or all of them "*".

Contributing

I welcome contributions to improve this library! If you have suggestions, bug reports, or new feature requests, please open an issue or submit a pull request on my GitHub repository.

License

This project is licensed under the MIT License. See the LICENSE file for details.

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

currencies_lib-1.0.3.tar.gz (10.1 kB view hashes)

Uploaded Source

Built Distribution

currencies_lib-1.0.3-py3-none-any.whl (9.7 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