iso4217

What it is and what it does

iso4217 wraps ISO 4217 currency data into a Python enum, letting you access currency metadata by code. Each currency entry includes its three-letter code, full name, and exponent (the number of decimal places in the currency's minor units—for example, USD has 2 for cents, JPY has 0). You can look up currencies by attribute (Currency.USD) or by string (Currency('USD')), and both forms return the same enum member.

The package is a thin, dependency-light data layer: it depends only on importlib-resources and works across Python 3.6 through 3.14. It's useful when you need reliable, standardized currency information without building your own lookup table or hitting an external API.

Use it for:

• Validate or normalize currency codes in financial applications or payment systems
• Determine decimal precision for currency formatting or rounding in multi-currency transactions
• Build currency selection dropdowns or autocomplete fields with standard ISO codes and names
• Localize or display currency names in internationalized applications

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides ISO 4217 currency data as a Python enum, allowing you to look up currency codes, names, and exponent values (minor unit precision) programmatically.

Yes. This is a stable, zero-vulnerability, permissive-licensed data package with low install friction and active maintenance. Install it if you need reliable ISO 4217 currency lookups; the enum interface is clean and the dependency footprint is minimal.

Install

iso4217 on PyPI

pip install iso4217

uv add iso4217

poetry add iso4217

Installing iso4217

Before you install

Low friction: pure Python wheel with a single lightweight dependency (importlib-resources). Active maintenance with a recent release and no known vulnerabilities.

License in practice

Public Domain license means no restrictions on use, modification, or distribution—you can use this freely in any project without license compliance concerns.

Quickstart

pip install iso4217

from iso4217 import Currency

usd = Currency.USD
print(usd.code)  # 'USD'
print(usd.currency_name)  # 'US Dollar'
print(usd.exponent)  # 2

Verify before relying

• Whether the enum includes all current ISO 4217 currencies or if there are known omissions
• How frequently the package updates when ISO 4217 standards change

Package facts

Evidence: iso4217-1.16.20260101-py2.py3-none-any.whl

Keywords: internationalization, i18n, currency, iso4217

Tags

More Financial packages