# 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:
```bash
$ pip install currencies-lib
```
>
### Example of use
```python
from currencies_lib import BRL
value = 1250.50
result = BRL(value, currency_symbol=True)
print(result)
#> "R$ 1.250,50"
```
or
```python
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](https://github.com/iamtwobe/currencies_lib).
>
### License
This project is licensed under the MIT License. See the [LICENSE](https://github.com/iamtwobe/currencies_lib/blob/main/LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/iamtwobe/currencies_lib",
"name": "currencies-lib",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "iamtwobe",
"author_email": "contato.iamtwobe@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/82/f9/1727c665b771cbb4a2d4b2c8fc1d809b82f31e9a271af93483c5ca66bc2d/currencies_lib-1.0.3.tar.gz",
"platform": null,
"description": "# Currencies Formatter\n\nThe **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.\n\n### Features\n- Format monetary values for a variety of currencies.\n- Customizable formatting options for currency symbols and decimal places.\n- Supports both standard and custom currency symbols.\n- Allows conversion of values to percentage format.\n- Utility functions for abbreviating units and detecting currency symbols.\n>\n### Installing\nYou can install this library with:\n```bash\n$ pip install currencies-lib\n```\n>\n\n### Example of use\n\n```python\nfrom currencies_lib import BRL\n\nvalue = 1250.50\nresult = BRL(value, currency_symbol=True)\nprint(result)\n#> \"R$ 1.250,50\"\n```\nor\n```python\nfrom currencies_lib import *\n\nvalue = 1250.50\nresult = Currency_Formatter.EUR(value, currency_symbol=True, eur_sign=True)\nprint(result)\n#> \"\u20ac 1.250,50\"\n```\n**Note**: Direct imports from the currencies_lib module are not recommended. Use from currencies_lib import ... to access specific formatters or all of them \"*\".\n\n>\n\n### Contributing\n\nI 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](https://github.com/iamtwobe/currencies_lib).\n>\n\n### License\nThis project is licensed under the MIT License. See the [LICENSE](https://github.com/iamtwobe/currencies_lib/blob/main/LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A currency formatter for many currencies",
"version": "1.0.3",
"project_urls": {
"Homepage": "https://github.com/iamtwobe/currencies_lib"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a4fac634bd55849827a639e6127a7e096aa962df58e59ea62fcb4c83da13ce3c",
"md5": "4f58d0ec32f047f696006c42ba732eb6",
"sha256": "ff9ea418c2943eceae01ccdb3da70c6fa00634c198ceffff33f433f9f7da1a07"
},
"downloads": -1,
"filename": "currencies_lib-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4f58d0ec32f047f696006c42ba732eb6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9713,
"upload_time": "2024-08-29T15:35:20",
"upload_time_iso_8601": "2024-08-29T15:35:20.161851Z",
"url": "https://files.pythonhosted.org/packages/a4/fa/c634bd55849827a639e6127a7e096aa962df58e59ea62fcb4c83da13ce3c/currencies_lib-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "82f91727c665b771cbb4a2d4b2c8fc1d809b82f31e9a271af93483c5ca66bc2d",
"md5": "a4b53d9aa95b9a6b5a92007628d7bbe3",
"sha256": "e144f6122ae6f7b79449030033c47161f3a5b1db0195424edf5b9cfd2ea1b3d6"
},
"downloads": -1,
"filename": "currencies_lib-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "a4b53d9aa95b9a6b5a92007628d7bbe3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10131,
"upload_time": "2024-08-29T15:35:22",
"upload_time_iso_8601": "2024-08-29T15:35:22.173976Z",
"url": "https://files.pythonhosted.org/packages/82/f9/1727c665b771cbb4a2d4b2c8fc1d809b82f31e9a271af93483c5ca66bc2d/currencies_lib-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-29 15:35:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "iamtwobe",
"github_project": "currencies_lib",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "currencies-lib"
}
JSON
