Currencies done right
In most payment systems that went international, amounts are represented in integers, instead of decimals, as they are represented in minor currency units (smallest units possible).
For EUR it is cent, which is 1/100 of a single Euro. For MRU it is khoums, which is 1/5 of a single Ouguiya.
List of currencies is generated from a single CSV dump obtained from the list of circulating currencies Wikipedia page using the awesome wikitable2csv.
- Core package requires Python 3.6, 3.7, 3.8 or 3.9.
- Django integration package (
valuta.contrib.django_integration
) requires Django 2.2, 3.0, 3.1 or 3.2. - SQLAlchemy integration package (
valuta.contrib.sqlalchemy_integration
) has been tested with SQLAlchemy 1.4.x.
Documentation is available on Read the Docs.
Latest stable version on PyPI:
pip install valuta
Or development version from GitHub:
pip install https://github.com/barseghyanartur/valuta/archive/master.tar.gz
import valuta
valuta.EUR.convert_to_currency_units(1_000)
# 10.0
valuta.UGX.convert_to_currency_units(1_000)
# 1000.0
valuta.MRU.convert_to_currency_units(1_000)
# 200.0
valuta.VND.convert_to_currency_units(1_000)
# 100.0
valuta.TND.convert_to_currency_units(1_000)
# 1.0
valuta.JPY.convert_to_currency_units(1_000)
# 10.0
import valuta
valuta.EUR.display_in_currency_units(1_000)
# 'β¬10.00'
valuta.UGX.display_in_currency_units(1_000)
# 'UGX1,000'
valuta.MRU.display_in_currency_units(1_000)
# 'MRU200.00'
valuta.VND.display_in_currency_units(1_000)
# 'β«100'
valuta.TND.display_in_currency_units(1_000)
# 'TND1.000'
valuta.JPY.display_in_currency_units(1_000)
# 'Β₯10'
Based on the specifics of the given currency, displayed numbers may have or not may have decimal points.
The display_in_currency_units
method accepts optional format
, locale
and decimal_quantization
arguments. Most common values for format
are listed in the valuta.constants
.
format
DISPLAY_FORMAT_NUMBER
Example values: '10000'
or '10000.00'
.
DISPLAY_FORMAT_HUMAN_READABLE
Displays a human readable number.
Example values: '10,000'
or '10,000.00'
.
DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_CODE
Displays a human readable number with currency code.
Example values: 'JPY 10,000'
or 'EUR 10,000.00'
.
DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_SYMBOL
Displays a human readable number with currency symbol.
Example values: 'Β₯ 10,000'
or 'β¬ 10,000.00'
.
A couple of examples:
from valuta.constants import *
valuta.JPY.display_in_currency_units(
1_000_000,
format=DISPLAY_FORMAT_HUMAN_READABLE
)
# '10,000'
valuta.JPY.display_in_currency_units(
1_000_000,
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_CODE
)
# 'JPY 10,000'
valuta.JPY.display_in_currency_units(
1_000_000,
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_SYMBOL
)
# 'Β₯ 10,000'
valuta.EUR.display_in_currency_units(
1_000_000,
format=DISPLAY_FORMAT_HUMAN_READABLE
)
# '10,000.00'
valuta.EUR.display_in_currency_units(
1_000_000,
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_CODE
)
# 'EUR 10,000.00'
valuta.EUR.display_in_currency_units(
1_000_000,
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_SYMBOL
)
# 'β¬ 10,000.00'
locale
valuta.JPY.display_in_currency_units(1_000_000_000, locale="nl_NL")
# 'JPΒ₯\xa010.000.000'
valuta.JPY.display_in_currency_units(1_000_000_000, locale="en_US")
# 'Β₯10,000,000'
valuta.EUR.display_in_currency_units(1_000_000_000, locale="nl_NL")
# 'β¬\xa010.000.000,00'
valuta.EUR.display_in_currency_units(1_000_000_000, locale="en_US") # 'β¬10,000,000.00'
valuta.AMD.display_in_currency_units(1_000_000_000, locale="en_US") # 'AMD10,000,000.00'
valuta.AMD.display_in_currency_units(1_000_000_000, locale="hy_AM") # '10 000 000,00 Φ'
from valuta.shortcuts import convert_to_currency_units
convert_to_currency_units("EUR", 1_000)
# 10.0
convert_to_currency_units("UGX", 1_000)
# 1000.0
convert_to_currency_units("MRU", 1_000)
# 200.0
convert_to_currency_units("VND", 1_000)
# 100.0
convert_to_currency_units("TND", 1_000)
# 1.0
convert_to_currency_units("JPY", 1_000)
# 10.0
from valuta.shortcuts import display_in_currency_units
display_in_currency_units("EUR", 1_000)
# 'β¬10.00'
display_in_currency_units("UGX", 1_000)
# 'UGX1,000'
display_in_currency_units("MRU", 1_000)
# 'MRU200.00'
display_in_currency_units("VND", 1_000)
# 'β«100'
display_in_currency_units("TND", 1_000)
# 'TND1.000'
display_in_currency_units("JPY", 1_000)
# 'Β₯10'
By default, exceptions arising from invalid currency codes are suppressed (None
will be returned on invalid currency codes).
If you want to throw exception on invalid currency codes, set fail_silently
to False
. The following example will throw a valuta.exceptions.InvalidCurrency
exception.
convert_to_currency_units("i-dont-exist", 1_000, fail_silently=False)
The display_in_currency_units
shortcut function also accepts optional format
argument.
In its basis, Django integration package is a CurrencyField
representing the ISO-4217 codes of the currencies. If bound to certain number fields (SmallIntegerField
, IntegerField
, BigIntegerField
) holding the amount in minor currency units, it adds up (magic) methods to the model class for converting field amounts to major currency units (often simply called currency units
).
There are also template tags and filters for when you need to render non-model data (for instance, JSON) in templates without prior pre-processing.
pip install valuta[django]
Sample model
product/models.py
from django.db import models
from valuta.contrib.django_integration.models import CurrencyField
class Product(models.Model):
name = models.CharField(max_length=255)
price = models.IntegerField() # Amount in minor currency units
price_with_tax = models.IntegerField() # Amount in minor currency units
currency = CurrencyField(amount_fields=["price", "price_with_tax"])
Sample data
import valuta
from product.models import Product
product = Product.objects.create(
name="My test product",
price=100,
price_with_tax=120,
currency=valuta.AMD.uid,
)
You could then refer to the price and price_with_tax as follows:
product.price_in_currency_units()
# 1.0
product.price_with_tax_in_currency_units()
# 1.2
Note, that every field listed in the amount_fields
gets a correspondent model method with suffix _in_currency_units
for converting the field amounts to (major) currency units.
You could then refer to the price and price_with_tax as follows:
product.price_display_in_currency_units()
# 'AMD1.00'
product.price_with_tax_display_in_currency_units()
# 'AMD1.20'
Note, that every field listed in the amount_fields
gets a correspondent model method with suffix _display_in_currency_units
for converting the field amounts to (major) currency units.
Magic methods also accept optional format
argument.
product = Product.objects.create(
name="My test product",
price=100_000,
price_with_tax=120_000,
currency=valuta.EUR.uid,
)
product.price_display_in_currency_units(
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_SYMBOL
)
# 'β¬ 1,000.00'
product.price_with_tax_display_in_currency_units(
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_CODE
)
# 'EUR 1,200.00'
Combining format
and locale
arguments.
product.price_display_in_currency_units(
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_SYMBOL,
locale="nl_NL"
)
# 'β¬ 1.000,00'
product.price_with_tax_display_in_currency_units(
format=DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_CODE,
locale="nl_NL"
)
# 'EUR 1.200,00'
You could limit the currency choices as follows:
currency = CurrencyField(
amount_fields=["price", "price_with_tax"],
limit_choices_to=[valuta.AMD.uid, valuta.EUR.uid],
)
You could also override the CurrencyField
choices in the Django settings:
settings.py
VALUTA_FIELD_LIMIT_CHOICES_TO=(
valuta.AMD.uid,
valuta.EUR.uid,
)
If you want to explicitly cast the result value to a certain type, provide a callable cast_to
for the CurrencyField
.
currency = CurrencyField(
amount_fields=("price", "price_with_tax",),
cast_to=int,
)
currency = CurrencyField(
amount_fields=("price", "price_with_tax",),
cast_to=float,
)
currency = CurrencyField(
amount_fields=("price", "price_with_tax",),
cast_to=lambda __v: Decimal(str(__v)),
)
By default, the following format is used (valuta.utils.get_currency_choices_with_code
):
[
("AMD", "Armenian Dram (AMD)"),
("EUR", "Euro (EUR)"),
]
If you want to customize that, provide a callable get_choices_func
along:
from valuta.utils import get_currency_choices
currency = CurrencyField(
amount_fields=("price", "price_with_tax",),
get_choices_func=get_currency_choices,
)
It would then have the following format:
[
("AMD", "Armenian Dram"),
("EUR", "Euro"),
]
Take both valuta.utils.get_currency_choices
and valuta.utils.get_currency_choices_with_code
as a good example of how to customize. You could for instance do something like this:
import operator
from typing import List, Tuple, Set, Union
from babel.numbers import get_currency_symbol
from valuta.base import Registry
def get_currency_choices_with_sign(
limit_choices_to: Union[Tuple[str, ...], List[str], Set[str]] = None,
sort_by_key: bool = False,
) -> List[Tuple[str, str]]:
"""Get currency choices with code.
List of choices in the following format::
[
("AMD", "AMD - Armenian Dram"),
("EUR", "β¬ - Euro"),
("USD", "$ - US Dollar"),
]
"""
if limit_choices_to is None:
values = [
(__key, f"{get_currency_symbol(__key)} - {__value.name}")
for __key, __value in Registry.REGISTRY.items()
]
else:
values = [
(__key, f"{get_currency_symbol(__key)} - {__value.name}")
for __key, __value in Registry.REGISTRY.items()
if __key in limit_choices_to
]
if sort_by_key:
values.sort(key=operator.itemgetter(0))
else:
values.sort(key=operator.itemgetter(1))
return values
And then use it as follows:
currency = CurrencyField(
amount_fields=("price", "price_with_tax",),
get_choices_func=get_currency_choices_with_sign,
)
Most of the cases would be covered by the Model field, but it could be that you will have non-model data (for instance, JSON) that you need to properly render in the templates (without prior pre-processing). In that case valuta_tags
template tags/filters library might help.
If you want to use templatetags library, you need to add valuta.contrib.django_integration
to your INSTALLED_APPS
:
INSTALLED_APPS = (
# ...
"valuta.contrib.django_integration",
# ...
)
If you want to make use of pre-defined rendering formats, it might be useful to add valuta.contrib.django_integration.context_processors.constants
to the context_processors
.
TEMPLATES = [{
# ...
"OPTIONS": {
# ...
"context_processors": [
"django.template.context_processors.debug",
"django.template.context_processors.request",
"django.contrib.auth.context_processors.auth",
"django.contrib.messages.context_processors.messages",
"valuta.contrib.django_integration.context_processors.constants",
],
# ...
},
# ...
}]
instance = {
"price": 1_000,
"price_with_tax": 1_200,
"currency_code": "EUR",
}
template_filter_price_in_currency_units.html
{% load valuta_tags %}
{{ instance.price|convert_to_currency_units:instance.currency_code }}
from django.template.loader import render_to_string
render_to_string(
"template_filter_price_in_currency_units.html", {"instance": instance}
)
template_tag_price_in_currency_units.html
{% load valuta_tags %}
{% convert_to_currency_units instance.price instance.currency_code %}
from django.template.loader import render_to_string
render_to_string(
"template_tag_price_in_currency_units.html", {"instance": instance}
)
template_filter_price_display_in_currency_units.html
{% load valuta_tags %}
{{ instance.price|display_in_currency_units:instance.currency_code }}
from django.template.loader import render_to_string
render_to_string(
"template_filter_price_display_in_currency_units.html", {"instance": instance}
)
template_tag_price_display_in_currency_units.html
{% load valuta_tags %}
{% display_in_currency_units instance.price instance.currency_code %}
You can also display units in specific format (including the currency symbol). Most common use-cases are pre-defined in valuta.constants
and if you have included the correspondent context processor as instructed above, you could use it as follows:
{% load valuta_tags %}
{% display_in_currency_units instance.price instance.currency_code DISPLAY_FORMAT_HUMAN_READABLE_WITH_CURRENCY_CODE %}
For the full list of options, see Custom string formatting.
from django.template.loader import render_to_string
render_to_string(
"template_tag_price_display_in_currency_units.html", {"instance": instance}
)
Similarly to Django integration package, the SQLAlchemy integration package is a simple CurrencyType
representing the ISO-4217 codes of the currencies.
No magic methods are implemented yet (although planned to). What you get is a simple SQLAlchemy type for storing the data. For the rest you will have to make use of the valuta.shortcuts
.
See examples/sqlalchemy_example/valuta_admin/models.py as a good example.
pip install valuta[sqlalchemy]
Sample model
product/models.py
from valuta.contrib.sqlalchemy_integration.types import CurrencyType
from . import db # Standard SQLAlchemy way
class Product(db.Model):
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.Unicode(64), unique=True)
price = db.Column(db.Integer())
price_with_tax = db.Column(db.Integer())
currency = db.Column(CurrencyType())
Sample data
import valuta
from product.models import Product
product = Product(
name="My test product",
price=100,
price_with_tax=120,
currency=valuta.AMD.uid,
)
Currencies marked with (*) are custom (added manually). The rest is obtained from the already mentioned list of circulating currencies.
βββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββ
β ISO code β Currency β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β AED β United Arab Emirates Dirham β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β AFN β Afghan Afghani β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ALL β Albanian Lek β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β AMD β Armenian Dram β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ANG β Netherlands Antillean Guilder β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β AOA β Angolan Kwanza β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ARS β Argentine Peso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β AUD β Australian Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β AWG β Aruban Florin β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β AZN β Azerbaijani Manat β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BAM β Bosnia-Herzegovina Convertible Mark β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BBD β Barbadian Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BDT β Bangladeshi Taka β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BGN β Bulgarian Lev β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BHD β Bahraini Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BIF β Burundian Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BMD β Bermudan Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BND β Brunei Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BOB β Bolivian Boliviano β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BRL β Brazilian Real β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BSD β Bahamian Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BTC β Bitcoin (*) β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BTN β Bhutanese Ngultrum β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BWP β Botswanan Pula β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BYN β Belarusian Ruble β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β BZD β Belize Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CAD β Canadian Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CDF β Congolese Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CHF β Swiss Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CKD β CKD β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CLP β Chilean Peso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CNY β Chinese Yuan β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β COP β Colombian Peso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CRC β Costa Rican ColΓ³n β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CUP β Cuban Peso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CVE β Cape Verdean Escudo β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β CZK β Czech Koruna β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β DJF β Djiboutian Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β DKK β Danish Krone β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β DOP β Dominican Peso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β DZD β Algerian Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β EGP β Egyptian Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ERN β Eritrean Nakfa β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ETB β Ethiopian Birr β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β EUR β Euro β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β FJD β Fijian Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β FKP β Falkland Islands Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β FOK β FOK β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GBP β British Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GEL β Georgian Lari β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GGP β GGP β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GHS β Ghanaian Cedi β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GIP β Gibraltar Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GMD β Gambian Dalasi β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GNF β Guinean Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GTQ β Guatemalan Quetzal β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β GYD β Guyanaese Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β HKD β Hong Kong Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β HNL β Honduran Lempira β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β HRK β Croatian Kuna β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β HTG β Haitian Gourde β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β HUF β Hungarian Forint β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β IDR β Indonesian Rupiah β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ILS β Israeli New Shekel β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β IMP β IMP β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β INR β Indian Rupee β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β IQD β Iraqi Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β IRR β Iranian Rial β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ISK β Icelandic KrΓ³na β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β JEP β JEP β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β JMD β Jamaican Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β JOD β Jordanian Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β JPY β Japanese Yen β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KES β Kenyan Shilling β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KGS β Kyrgystani Som β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KHR β Cambodian Riel β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KID β KID β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KMF β Comorian Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KPW β North Korean Won β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KRW β South Korean Won β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KWD β Kuwaiti Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KYD β Cayman Islands Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β KZT β Kazakhstani Tenge β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β LAK β Laotian Kip β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β LBP β Lebanese Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β LKR β Sri Lankan Rupee β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β LRD β Liberian Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β LSL β Lesotho Loti β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β LYD β Libyan Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MAD β Moroccan Dirham β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MDL β Moldovan Leu β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MGA β Malagasy Ariary β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MKD β Macedonian Denar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MMK β Myanmar Kyat β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MNT β Mongolian Tugrik β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MOP β Macanese Pataca β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MRU β Mauritanian Ouguiya β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MUR β Mauritian Rupee β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MVR β Maldivian Rufiyaa β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MWK β Malawian Kwacha β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MXN β Mexican Peso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MYR β Malaysian Ringgit β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β MZN β Mozambican Metical β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β NAD β Namibian Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β NGN β Nigerian Naira β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β NIO β Nicaraguan CΓ³rdoba β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β NOK β Norwegian Krone β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β NPR β Nepalese Rupee β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β NZD β New Zealand Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β OMR β Omani Rial β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PAB β Panamanian Balboa β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PEN β Peruvian Sol β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PGK β Papua New Guinean Kina β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PHP β Philippine Piso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PKR β Pakistani Rupee β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PLN β Polish Zloty β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PND β PND β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PRB β PRB β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β PYG β Paraguayan Guarani β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β QAR β Qatari Rial β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β RON β Romanian Leu β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β RSD β Serbian Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β RUB β Russian Ruble β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β RWF β Rwandan Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SAR β Saudi Riyal β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SBD β Solomon Islands Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SCR β Seychellois Rupee β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SDG β Sudanese Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SEK β Swedish Krona β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SGD β Singapore Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SHP β St. Helena Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SLL β Sierra Leonean Leone β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SLS β SLS β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SOS β Somali Shilling β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SRD β Surinamese Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SSP β South Sudanese Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β STN β SΓ£o TomΓ© & PrΓncipe Dobra β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SYP β Syrian Pound β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β SZL β Swazi Lilangeni β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β THB β Thai Baht β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TJS β Tajikistani Somoni β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TMT β Turkmenistani Manat β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TND β Tunisian Dinar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TOP β Tongan PaΚ»anga β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TRY β Turkish Lira β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TTD β Trinidad & Tobago Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TVD β TVD β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TWD β New Taiwan Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β TZS β Tanzanian Shilling β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β UAH β Ukrainian Hryvnia β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β UGX β Ugandan Shilling β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β USD β US Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β UYU β Uruguayan Peso β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β UZS β Uzbekistani Som β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β VES β Venezuelan BolΓvar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β VND β Vietnamese Dong β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β VUV β Vanuatu Vatu β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β WST β Samoan Tala β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β XAF β Central African CFA Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β XCD β East Caribbean Dollar β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β XOF β West African CFA Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β XPF β CFP Franc β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β YER β Yemeni Rial β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ZAR β South African Rand β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ZMW β Zambian Kwacha β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββ€
β ZWB β ZWB β
βββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββ
Run the following command in terminal to list all available currencies:
valuta-list-currencies
To register a new custom currency, do as follows:
from valuta.base import BaseCurrency
class XYZ(BaseCurrency):
"""XYZ - The XYZ currency."""
uid: str = "XYZ"
rate: int = 100_000_000
If list of circulating currencies is ever updated, grab it the same way, save as list_of_circulating_currencies.csv in the source and run the following command:
valuta-generate-currencies --skip-first-line
Simply type:
pytest -vvv
Or use tox:
tox
Or use tox to check specific env:
tox -e py39-django32
Keep the following hierarchy.
=====
title
=====
header
======
sub-header
----------
sub-sub-header
~~~~~~~~~~~~~~
sub-sub-sub-header
^^^^^^^^^^^^^^^^^^
sub-sub-sub-sub-header
++++++++++++++++++++++
sub-sub-sub-sub-sub-header
**************************
GPL-2.0-only OR LGPL-2.1-or-later
For any issues contact me at the e-mail given in the Author section.
Artur Barseghyan <artur.barseghyan@gmail.com>