Lightweight ISO 4217 currency package
Project description
python-iso4217
: fast currency data package for Python
This python package automatically updates its own currency data using github actions and immediately release new version of package with updates. So it's super fast and at the same time always contains fresh data.
Installation
Pip
pip install python-iso4217
Poetry
poetry add python-iso4217
Usage
from iso4217 import find_currency, iter_currency
# Filters that could be applied:
# * currency_name
# * alphabetical_code
# * entity
# * decimal_places
# * numeric_code
# * withdrawal_date
# The filters correspond to attributes of `Currency` class
# accept arbitrary filters as key/value pairs
currency = find_currency(currency_name="usd")
# if currency was not found, the lib will immediately raise CurrencyNotFoundError
defunct_currency = find_currency(currency_name="abc123")
# You need generator to lazy iter currencies? Ok
for c in iter_currency():
# do something
Advanced
Work with pydantic
import inspect
from iso4217 import Currency as _Currency, find_currency
from pydantic import BaseModel, root_validator, StrictInt
class Currency(BaseModel, _Currency):
__root__: StrictInt
@root_validator(skip_on_failure=True)
def humanize(cls, values):
currency_numeric_code: int = values.get("__root__")
# inspect.getfullargspec(_Currency.__init__) will contain `self`, so we cut it off
orig_currency_cls_dunder_init_arg_names = inspect.getfullargspec(_Currency.__init__).args[1:]
currency = find_currency(numeric_code=currency_numeric_code)
return {
k: getattr(currency, k, None)
for k in orig_currency_cls_dunder_init_arg_names
}
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
python-iso4217-0.0.4.tar.gz
(4.0 kB
view hashes)
Built Distribution
Close
Hashes for python_iso4217-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 06fb083693c90f3978d7a188e4a9d22d34ae798c7583d2e3fe2701423f296598 |
|
MD5 | 04068596ce0b3fe52b100bdd3e9be2f7 |
|
BLAKE2b-256 | 345b2279e21385081efe21a58ec6243cec9faa1eecb77826c8e02482cff3c85f |