ccy

library2.0.0pypypi✓ verified 83d ago

A lightweight Python library for working with currency information, including ISO 4217 codes, numeric codes, and minor unit exponents. The current version is 2.0.0, which requires Python >=3.11 and introduces breaking changes from v1.x. Release cadence is sporadic.

finance

pip install ccy

INSTALL

IMPORT

SIG · CCY

ccy

financepythonv2.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CCY

✓ from ccy import CCY

✗ from ccy import Currency

Currency

✓ from ccy.currency import Currency

CountryError

✓ from ccy import CountryError

Get currency metadata using the Currency class.

from ccy import Currency # Look up currency by ISO code usd = Currency('USD') print(usd.name) # United States dollar print(usd.iso_numeric) # 840 print(usd.minor_units) # 2 # List all currencies all_currencies = Currency.instances() print(len(all_currencies))

Debug

Known issues

breakingPublic API moved from submodules (ccy.core, ccy.country, etc.) to top-level package. Direct imports like `from ccy.core import Currency` will fail in v2.

fix

Use `from ccy import Currency` instead.

affects: >=2.0.0

breakingPython 3.11 minimum is required. Python 3.9 and 3.10 are no longer supported.

fix

Upgrade to Python 3.11+ or stay on v1.x.

affects: >=2.0.0

deprecatedThe `currency` function (lowercase) is deprecated in favor of the `Currency` class.

fix

Use `Currency(code)` instead of `currency(code)`.

affects: >=2.0.0

gotcha`Currency.instances()` is now a class method. In v1, it was a standalone function `ccy.currency.all()`.

fix

Use `Currency.instances()` to get all currencies.

affects: >=2.0.0

Upgrade

Version history

2.0.0latest on PyPI · released Mar 28, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

41 hits · last 30 days

node

Resources

No resource links recorded.