valuta package

Subpackages

Submodules

valuta.base module

class valuta.base.BaseCurrency[source]

Bases: object

Base currency.

Each currency typically has a main currency unit (the dollar, for example, or the euro) and a fractional unit, often defined as 1⁄100 of the main unit: 100 cents = 1 dollar, 100 centimes = 1 franc, 100 pence = 1 pound, although units of 1⁄10 or 1⁄1000 occasionally also occur. Some currencies do not have any smaller units at all, such as the Icelandic krona.

https://en.wikipedia.org/wiki/Currency

classmethod convert_to_currency_units(value: int) → Union[int, float, decimal.Decimal][source]

Convert to amount in currency units.

classmethod display_in_currency_units(value: int, format: Optional[str] = None, locale: Optional[str] = None, decimal_quantization: bool = True) → str[source]

Convert to amount in currency units.

name = None
rate: Union[int, float, decimal.Decimal]
symbol = None
uid: Optional[str] = None
classmethod validate()[source]

Constructor.

class valuta.base.Registry(name, bases, attrs)[source]

Bases: type

REGISTRY: Dict[str, valuta.base.BaseCurrency] = {'AED': <class 'valuta.currencies.aed.AED'>, 'AFN': <class 'valuta.currencies.afn.AFN'>, 'ALL': <class 'valuta.currencies.all.ALL'>, 'AMD': <class 'valuta.currencies.amd.AMD'>, 'ANG': <class 'valuta.currencies.ang.ANG'>, 'AOA': <class 'valuta.currencies.aoa.AOA'>, 'ARS': <class 'valuta.currencies.ars.ARS'>, 'AUD': <class 'valuta.currencies.aud.AUD'>, 'AWG': <class 'valuta.currencies.awg.AWG'>, 'AZN': <class 'valuta.currencies.azn.AZN'>, 'BAM': <class 'valuta.currencies.bam.BAM'>, 'BBD': <class 'valuta.currencies.bbd.BBD'>, 'BDT': <class 'valuta.currencies.bdt.BDT'>, 'BGN': <class 'valuta.currencies.bgn.BGN'>, 'BHD': <class 'valuta.currencies.bhd.BHD'>, 'BIF': <class 'valuta.currencies.bif.BIF'>, 'BMD': <class 'valuta.currencies.bmd.BMD'>, 'BND': <class 'valuta.currencies.bnd.BND'>, 'BOB': <class 'valuta.currencies.bob.BOB'>, 'BRL': <class 'valuta.currencies.brl.BRL'>, 'BSD': <class 'valuta.currencies.bsd.BSD'>, 'BTC': <class 'valuta.currencies.btc.BTC'>, 'BTN': <class 'valuta.currencies.btn.BTN'>, 'BWP': <class 'valuta.currencies.bwp.BWP'>, 'BYN': <class 'valuta.currencies.byn.BYN'>, 'BZD': <class 'valuta.currencies.bzd.BZD'>, 'CAD': <class 'valuta.currencies.cad.CAD'>, 'CDF': <class 'valuta.currencies.cdf.CDF'>, 'CHF': <class 'valuta.currencies.chf.CHF'>, 'CKD': <class 'valuta.currencies.ckd.CKD'>, 'CLP': <class 'valuta.currencies.clp.CLP'>, 'CNY': <class 'valuta.currencies.cny.CNY'>, 'COP': <class 'valuta.currencies.cop.COP'>, 'CRC': <class 'valuta.currencies.crc.CRC'>, 'CUP': <class 'valuta.currencies.cup.CUP'>, 'CVE': <class 'valuta.currencies.cve.CVE'>, 'CZK': <class 'valuta.currencies.czk.CZK'>, 'DJF': <class 'valuta.currencies.djf.DJF'>, 'DKK': <class 'valuta.currencies.dkk.DKK'>, 'DOP': <class 'valuta.currencies.dop.DOP'>, 'DZD': <class 'valuta.currencies.dzd.DZD'>, 'EGP': <class 'valuta.currencies.egp.EGP'>, 'ERN': <class 'valuta.currencies.ern.ERN'>, 'ETB': <class 'valuta.currencies.etb.ETB'>, 'EUR': <class 'valuta.currencies.eur.EUR'>, 'FJD': <class 'valuta.currencies.fjd.FJD'>, 'FKP': <class 'valuta.currencies.fkp.FKP'>, 'FOK': <class 'valuta.currencies.fok.FOK'>, 'GBP': <class 'valuta.currencies.gbp.GBP'>, 'GEL': <class 'valuta.currencies.gel.GEL'>, 'GGP': <class 'valuta.currencies.ggp.GGP'>, 'GHS': <class 'valuta.currencies.ghs.GHS'>, 'GIP': <class 'valuta.currencies.gip.GIP'>, 'GMD': <class 'valuta.currencies.gmd.GMD'>, 'GNF': <class 'valuta.currencies.gnf.GNF'>, 'GTQ': <class 'valuta.currencies.gtq.GTQ'>, 'GYD': <class 'valuta.currencies.gyd.GYD'>, 'HKD': <class 'valuta.currencies.hkd.HKD'>, 'HNL': <class 'valuta.currencies.hnl.HNL'>, 'HRK': <class 'valuta.currencies.hrk.HRK'>, 'HTG': <class 'valuta.currencies.htg.HTG'>, 'HUF': <class 'valuta.currencies.huf.HUF'>, 'IDR': <class 'valuta.currencies.idr.IDR'>, 'ILS': <class 'valuta.currencies.ils.ILS'>, 'IMP': <class 'valuta.currencies.imp.IMP'>, 'INR': <class 'valuta.currencies.inr.INR'>, 'IQD': <class 'valuta.currencies.iqd.IQD'>, 'IRR': <class 'valuta.currencies.irr.IRR'>, 'ISK': <class 'valuta.currencies.isk.ISK'>, 'JEP': <class 'valuta.currencies.jep.JEP'>, 'JMD': <class 'valuta.currencies.jmd.JMD'>, 'JOD': <class 'valuta.currencies.jod.JOD'>, 'JPY': <class 'valuta.currencies.jpy.JPY'>, 'KES': <class 'valuta.currencies.kes.KES'>, 'KGS': <class 'valuta.currencies.kgs.KGS'>, 'KHR': <class 'valuta.currencies.khr.KHR'>, 'KID': <class 'valuta.currencies.kid.KID'>, 'KMF': <class 'valuta.currencies.kmf.KMF'>, 'KPW': <class 'valuta.currencies.kpw.KPW'>, 'KRW': <class 'valuta.currencies.krw.KRW'>, 'KWD': <class 'valuta.currencies.kwd.KWD'>, 'KYD': <class 'valuta.currencies.kyd.KYD'>, 'KZT': <class 'valuta.currencies.kzt.KZT'>, 'LAK': <class 'valuta.currencies.lak.LAK'>, 'LBP': <class 'valuta.currencies.lbp.LBP'>, 'LKR': <class 'valuta.currencies.lkr.LKR'>, 'LRD': <class 'valuta.currencies.lrd.LRD'>, 'LSL': <class 'valuta.currencies.lsl.LSL'>, 'LYD': <class 'valuta.currencies.lyd.LYD'>, 'MAD': <class 'valuta.currencies.mad.MAD'>, 'MDL': <class 'valuta.currencies.mdl.MDL'>, 'MGA': <class 'valuta.currencies.mga.MGA'>, 'MKD': <class 'valuta.currencies.mkd.MKD'>, 'MMK': <class 'valuta.currencies.mmk.MMK'>, 'MNT': <class 'valuta.currencies.mnt.MNT'>, 'MOP': <class 'valuta.currencies.mop.MOP'>, 'MRU': <class 'valuta.currencies.mru.MRU'>, 'MUR': <class 'valuta.currencies.mur.MUR'>, 'MVR': <class 'valuta.currencies.mvr.MVR'>, 'MWK': <class 'valuta.currencies.mwk.MWK'>, 'MXN': <class 'valuta.currencies.mxn.MXN'>, 'MYR': <class 'valuta.currencies.myr.MYR'>, 'MZN': <class 'valuta.currencies.mzn.MZN'>, 'NAD': <class 'valuta.currencies.nad.NAD'>, 'NGN': <class 'valuta.currencies.ngn.NGN'>, 'NIO': <class 'valuta.currencies.nio.NIO'>, 'NOK': <class 'valuta.currencies.nok.NOK'>, 'NPR': <class 'valuta.currencies.npr.NPR'>, 'NZD': <class 'valuta.currencies.nzd.NZD'>, 'OMR': <class 'valuta.currencies.omr.OMR'>, 'PAB': <class 'valuta.currencies.pab.PAB'>, 'PEN': <class 'valuta.currencies.pen.PEN'>, 'PGK': <class 'valuta.currencies.pgk.PGK'>, 'PHP': <class 'valuta.currencies.php.PHP'>, 'PKR': <class 'valuta.currencies.pkr.PKR'>, 'PLN': <class 'valuta.currencies.pln.PLN'>, 'PND': <class 'valuta.currencies.pnd.PND'>, 'PRB': <class 'valuta.currencies.prb.PRB'>, 'PYG': <class 'valuta.currencies.pyg.PYG'>, 'QAR': <class 'valuta.currencies.qar.QAR'>, 'RON': <class 'valuta.currencies.ron.RON'>, 'RSD': <class 'valuta.currencies.rsd.RSD'>, 'RUB': <class 'valuta.currencies.rub.RUB'>, 'RWF': <class 'valuta.currencies.rwf.RWF'>, 'SAR': <class 'valuta.currencies.sar.SAR'>, 'SBD': <class 'valuta.currencies.sbd.SBD'>, 'SCR': <class 'valuta.currencies.scr.SCR'>, 'SDG': <class 'valuta.currencies.sdg.SDG'>, 'SEK': <class 'valuta.currencies.sek.SEK'>, 'SGD': <class 'valuta.currencies.sgd.SGD'>, 'SHP': <class 'valuta.currencies.shp.SHP'>, 'SLL': <class 'valuta.currencies.sll.SLL'>, 'SLS': <class 'valuta.currencies.sls.SLS'>, 'SOS': <class 'valuta.currencies.sos.SOS'>, 'SRD': <class 'valuta.currencies.srd.SRD'>, 'SSP': <class 'valuta.currencies.ssp.SSP'>, 'STN': <class 'valuta.currencies.stn.STN'>, 'SYP': <class 'valuta.currencies.syp.SYP'>, 'SZL': <class 'valuta.currencies.szl.SZL'>, 'THB': <class 'valuta.currencies.thb.THB'>, 'TJS': <class 'valuta.currencies.tjs.TJS'>, 'TMT': <class 'valuta.currencies.tmt.TMT'>, 'TND': <class 'valuta.currencies.tnd.TND'>, 'TOP': <class 'valuta.currencies.top.TOP'>, 'TRY': <class 'valuta.currencies.try.TRY'>, 'TTD': <class 'valuta.currencies.ttd.TTD'>, 'TVD': <class 'valuta.currencies.tvd.TVD'>, 'TWD': <class 'valuta.currencies.twd.TWD'>, 'TZS': <class 'valuta.currencies.tzs.TZS'>, 'UAH': <class 'valuta.currencies.uah.UAH'>, 'UGX': <class 'valuta.currencies.ugx.UGX'>, 'USD': <class 'valuta.currencies.usd.USD'>, 'UYU': <class 'valuta.currencies.uyu.UYU'>, 'UZS': <class 'valuta.currencies.uzs.UZS'>, 'VES': <class 'valuta.currencies.ves.VES'>, 'VND': <class 'valuta.currencies.vnd.VND'>, 'VUV': <class 'valuta.currencies.vuv.VUV'>, 'WST': <class 'valuta.currencies.wst.WST'>, 'XAF': <class 'valuta.currencies.xaf.XAF'>, 'XCD': <class 'valuta.currencies.xcd.XCD'>, 'XOF': <class 'valuta.currencies.xof.XOF'>, 'XPF': <class 'valuta.currencies.xpf.XPF'>, 'YER': <class 'valuta.currencies.yer.YER'>, 'ZAR': <class 'valuta.currencies.zar.ZAR'>, 'ZMW': <class 'valuta.currencies.zmw.ZMW'>, 'ZWB': <class 'valuta.currencies.zwb.ZWB'>}
classmethod get(key: str, default: Optional[valuta.base.BaseCurrency] = None) → Optional[valuta.base.BaseCurrency][source]
classmethod items() → ItemsView[str, valuta.base.BaseCurrency][source]
classmethod reset() → None[source]
classmethod values(limit_choices_to: Optional[Union[List[str], Tuple[str, ...], Set[str]]] = None, sort_by_key: bool = False) → List[Tuple[str, str]][source]
classmethod values_with_code(limit_choices_to: Optional[Union[List[str], Tuple[str, ...], Set[str]]] = None, sort_by_key: bool = False) → List[Tuple[str, str]][source]

valuta.cli module

valuta.cli.generate_currencies()[source]

Generate currency modules.

valuta.cli.list_currencies()[source]

List currency modules.

valuta.exceptions module

exception valuta.exceptions.ImproperlyConfigured[source]

Bases: Exception

ImproperlyConfigured.

Supposed to be thrown when code is improperly configured.

exception valuta.exceptions.InvalidCurrency[source]

Bases: ValueError

Invalid currency exception.

valuta.helpers module

class valuta.helpers.ClassProperty(fget=None, fset=None, fdel=None, doc=None)[source]

Bases: property

ClassProperty.

How to use:

class Something:
    @classproperty
    def default_value(cls):
        return 10  # Some value

Can be replaced with the following in Python 3.9:

class Something:
    @classmethod
    @property
    def default_value(cls):
        return 10  # Some value
valuta.helpers.classproperty

alias of valuta.helpers.ClassProperty

valuta.helpers.project_dir(base: str) → str[source]

Absolute path to a file from current directory.

valuta.registry module

class valuta.registry.Registry(name, bases, attrs)[source]

Bases: type

REGISTRY: Dict[str, valuta.base.BaseCurrency] = {'AED': <class 'valuta.currencies.aed.AED'>, 'AFN': <class 'valuta.currencies.afn.AFN'>, 'ALL': <class 'valuta.currencies.all.ALL'>, 'AMD': <class 'valuta.currencies.amd.AMD'>, 'ANG': <class 'valuta.currencies.ang.ANG'>, 'AOA': <class 'valuta.currencies.aoa.AOA'>, 'ARS': <class 'valuta.currencies.ars.ARS'>, 'AUD': <class 'valuta.currencies.aud.AUD'>, 'AWG': <class 'valuta.currencies.awg.AWG'>, 'AZN': <class 'valuta.currencies.azn.AZN'>, 'BAM': <class 'valuta.currencies.bam.BAM'>, 'BBD': <class 'valuta.currencies.bbd.BBD'>, 'BDT': <class 'valuta.currencies.bdt.BDT'>, 'BGN': <class 'valuta.currencies.bgn.BGN'>, 'BHD': <class 'valuta.currencies.bhd.BHD'>, 'BIF': <class 'valuta.currencies.bif.BIF'>, 'BMD': <class 'valuta.currencies.bmd.BMD'>, 'BND': <class 'valuta.currencies.bnd.BND'>, 'BOB': <class 'valuta.currencies.bob.BOB'>, 'BRL': <class 'valuta.currencies.brl.BRL'>, 'BSD': <class 'valuta.currencies.bsd.BSD'>, 'BTC': <class 'valuta.currencies.btc.BTC'>, 'BTN': <class 'valuta.currencies.btn.BTN'>, 'BWP': <class 'valuta.currencies.bwp.BWP'>, 'BYN': <class 'valuta.currencies.byn.BYN'>, 'BZD': <class 'valuta.currencies.bzd.BZD'>, 'CAD': <class 'valuta.currencies.cad.CAD'>, 'CDF': <class 'valuta.currencies.cdf.CDF'>, 'CHF': <class 'valuta.currencies.chf.CHF'>, 'CKD': <class 'valuta.currencies.ckd.CKD'>, 'CLP': <class 'valuta.currencies.clp.CLP'>, 'CNY': <class 'valuta.currencies.cny.CNY'>, 'COP': <class 'valuta.currencies.cop.COP'>, 'CRC': <class 'valuta.currencies.crc.CRC'>, 'CUP': <class 'valuta.currencies.cup.CUP'>, 'CVE': <class 'valuta.currencies.cve.CVE'>, 'CZK': <class 'valuta.currencies.czk.CZK'>, 'DJF': <class 'valuta.currencies.djf.DJF'>, 'DKK': <class 'valuta.currencies.dkk.DKK'>, 'DOP': <class 'valuta.currencies.dop.DOP'>, 'DZD': <class 'valuta.currencies.dzd.DZD'>, 'EGP': <class 'valuta.currencies.egp.EGP'>, 'ERN': <class 'valuta.currencies.ern.ERN'>, 'ETB': <class 'valuta.currencies.etb.ETB'>, 'EUR': <class 'valuta.currencies.eur.EUR'>, 'FJD': <class 'valuta.currencies.fjd.FJD'>, 'FKP': <class 'valuta.currencies.fkp.FKP'>, 'FOK': <class 'valuta.currencies.fok.FOK'>, 'GBP': <class 'valuta.currencies.gbp.GBP'>, 'GEL': <class 'valuta.currencies.gel.GEL'>, 'GGP': <class 'valuta.currencies.ggp.GGP'>, 'GHS': <class 'valuta.currencies.ghs.GHS'>, 'GIP': <class 'valuta.currencies.gip.GIP'>, 'GMD': <class 'valuta.currencies.gmd.GMD'>, 'GNF': <class 'valuta.currencies.gnf.GNF'>, 'GTQ': <class 'valuta.currencies.gtq.GTQ'>, 'GYD': <class 'valuta.currencies.gyd.GYD'>, 'HKD': <class 'valuta.currencies.hkd.HKD'>, 'HNL': <class 'valuta.currencies.hnl.HNL'>, 'HRK': <class 'valuta.currencies.hrk.HRK'>, 'HTG': <class 'valuta.currencies.htg.HTG'>, 'HUF': <class 'valuta.currencies.huf.HUF'>, 'IDR': <class 'valuta.currencies.idr.IDR'>, 'ILS': <class 'valuta.currencies.ils.ILS'>, 'IMP': <class 'valuta.currencies.imp.IMP'>, 'INR': <class 'valuta.currencies.inr.INR'>, 'IQD': <class 'valuta.currencies.iqd.IQD'>, 'IRR': <class 'valuta.currencies.irr.IRR'>, 'ISK': <class 'valuta.currencies.isk.ISK'>, 'JEP': <class 'valuta.currencies.jep.JEP'>, 'JMD': <class 'valuta.currencies.jmd.JMD'>, 'JOD': <class 'valuta.currencies.jod.JOD'>, 'JPY': <class 'valuta.currencies.jpy.JPY'>, 'KES': <class 'valuta.currencies.kes.KES'>, 'KGS': <class 'valuta.currencies.kgs.KGS'>, 'KHR': <class 'valuta.currencies.khr.KHR'>, 'KID': <class 'valuta.currencies.kid.KID'>, 'KMF': <class 'valuta.currencies.kmf.KMF'>, 'KPW': <class 'valuta.currencies.kpw.KPW'>, 'KRW': <class 'valuta.currencies.krw.KRW'>, 'KWD': <class 'valuta.currencies.kwd.KWD'>, 'KYD': <class 'valuta.currencies.kyd.KYD'>, 'KZT': <class 'valuta.currencies.kzt.KZT'>, 'LAK': <class 'valuta.currencies.lak.LAK'>, 'LBP': <class 'valuta.currencies.lbp.LBP'>, 'LKR': <class 'valuta.currencies.lkr.LKR'>, 'LRD': <class 'valuta.currencies.lrd.LRD'>, 'LSL': <class 'valuta.currencies.lsl.LSL'>, 'LYD': <class 'valuta.currencies.lyd.LYD'>, 'MAD': <class 'valuta.currencies.mad.MAD'>, 'MDL': <class 'valuta.currencies.mdl.MDL'>, 'MGA': <class 'valuta.currencies.mga.MGA'>, 'MKD': <class 'valuta.currencies.mkd.MKD'>, 'MMK': <class 'valuta.currencies.mmk.MMK'>, 'MNT': <class 'valuta.currencies.mnt.MNT'>, 'MOP': <class 'valuta.currencies.mop.MOP'>, 'MRU': <class 'valuta.currencies.mru.MRU'>, 'MUR': <class 'valuta.currencies.mur.MUR'>, 'MVR': <class 'valuta.currencies.mvr.MVR'>, 'MWK': <class 'valuta.currencies.mwk.MWK'>, 'MXN': <class 'valuta.currencies.mxn.MXN'>, 'MYR': <class 'valuta.currencies.myr.MYR'>, 'MZN': <class 'valuta.currencies.mzn.MZN'>, 'NAD': <class 'valuta.currencies.nad.NAD'>, 'NGN': <class 'valuta.currencies.ngn.NGN'>, 'NIO': <class 'valuta.currencies.nio.NIO'>, 'NOK': <class 'valuta.currencies.nok.NOK'>, 'NPR': <class 'valuta.currencies.npr.NPR'>, 'NZD': <class 'valuta.currencies.nzd.NZD'>, 'OMR': <class 'valuta.currencies.omr.OMR'>, 'PAB': <class 'valuta.currencies.pab.PAB'>, 'PEN': <class 'valuta.currencies.pen.PEN'>, 'PGK': <class 'valuta.currencies.pgk.PGK'>, 'PHP': <class 'valuta.currencies.php.PHP'>, 'PKR': <class 'valuta.currencies.pkr.PKR'>, 'PLN': <class 'valuta.currencies.pln.PLN'>, 'PND': <class 'valuta.currencies.pnd.PND'>, 'PRB': <class 'valuta.currencies.prb.PRB'>, 'PYG': <class 'valuta.currencies.pyg.PYG'>, 'QAR': <class 'valuta.currencies.qar.QAR'>, 'RON': <class 'valuta.currencies.ron.RON'>, 'RSD': <class 'valuta.currencies.rsd.RSD'>, 'RUB': <class 'valuta.currencies.rub.RUB'>, 'RWF': <class 'valuta.currencies.rwf.RWF'>, 'SAR': <class 'valuta.currencies.sar.SAR'>, 'SBD': <class 'valuta.currencies.sbd.SBD'>, 'SCR': <class 'valuta.currencies.scr.SCR'>, 'SDG': <class 'valuta.currencies.sdg.SDG'>, 'SEK': <class 'valuta.currencies.sek.SEK'>, 'SGD': <class 'valuta.currencies.sgd.SGD'>, 'SHP': <class 'valuta.currencies.shp.SHP'>, 'SLL': <class 'valuta.currencies.sll.SLL'>, 'SLS': <class 'valuta.currencies.sls.SLS'>, 'SOS': <class 'valuta.currencies.sos.SOS'>, 'SRD': <class 'valuta.currencies.srd.SRD'>, 'SSP': <class 'valuta.currencies.ssp.SSP'>, 'STN': <class 'valuta.currencies.stn.STN'>, 'SYP': <class 'valuta.currencies.syp.SYP'>, 'SZL': <class 'valuta.currencies.szl.SZL'>, 'THB': <class 'valuta.currencies.thb.THB'>, 'TJS': <class 'valuta.currencies.tjs.TJS'>, 'TMT': <class 'valuta.currencies.tmt.TMT'>, 'TND': <class 'valuta.currencies.tnd.TND'>, 'TOP': <class 'valuta.currencies.top.TOP'>, 'TRY': <class 'valuta.currencies.try.TRY'>, 'TTD': <class 'valuta.currencies.ttd.TTD'>, 'TVD': <class 'valuta.currencies.tvd.TVD'>, 'TWD': <class 'valuta.currencies.twd.TWD'>, 'TZS': <class 'valuta.currencies.tzs.TZS'>, 'UAH': <class 'valuta.currencies.uah.UAH'>, 'UGX': <class 'valuta.currencies.ugx.UGX'>, 'USD': <class 'valuta.currencies.usd.USD'>, 'UYU': <class 'valuta.currencies.uyu.UYU'>, 'UZS': <class 'valuta.currencies.uzs.UZS'>, 'VES': <class 'valuta.currencies.ves.VES'>, 'VND': <class 'valuta.currencies.vnd.VND'>, 'VUV': <class 'valuta.currencies.vuv.VUV'>, 'WST': <class 'valuta.currencies.wst.WST'>, 'XAF': <class 'valuta.currencies.xaf.XAF'>, 'XCD': <class 'valuta.currencies.xcd.XCD'>, 'XOF': <class 'valuta.currencies.xof.XOF'>, 'XPF': <class 'valuta.currencies.xpf.XPF'>, 'YER': <class 'valuta.currencies.yer.YER'>, 'ZAR': <class 'valuta.currencies.zar.ZAR'>, 'ZMW': <class 'valuta.currencies.zmw.ZMW'>, 'ZWB': <class 'valuta.currencies.zwb.ZWB'>}
classmethod get(key: str, default: Optional[valuta.base.BaseCurrency] = None) → Optional[valuta.base.BaseCurrency][source]
classmethod items() → ItemsView[str, valuta.base.BaseCurrency][source]
classmethod reset() → None[source]
classmethod values(limit_choices_to: Optional[Union[List[str], Tuple[str, ...], Set[str]]] = None, sort_by_key: bool = False) → List[Tuple[str, str]][source]
classmethod values_with_code(limit_choices_to: Optional[Union[List[str], Tuple[str, ...], Set[str]]] = None, sort_by_key: bool = False) → List[Tuple[str, str]][source]

valuta.scaffolding module

valuta.scaffolding.generate_contents(iso_code: str, number_to_basic: str, currency: str) → str[source]

Generate the contents for the given currency.

valuta.scaffolding.read_csv_and_write_output(in_file: str = 'list_of_circulating_currencies.csv', out_dir: str = 'currencies', skip_first_line: bool = False) → str[source]

Read CSV.

valuta.shortcuts module

valuta.shortcuts.convert_to_currency_units(currency_code: str, value: int, fail_silently: bool = True) → Optional[Union[int, float, decimal.Decimal]][source]

Convert value represented in minor currency to major currency units.

valuta.shortcuts.display_in_currency_units(currency_code: str, value: int, format: Optional[str] = None, locale: Optional[str] = None, decimal_quantization: bool = True, fail_silently: bool = True) → Optional[str][source]

Convert value represented in minor currency to major currency units.

valuta.utils module

valuta.utils.get_currency_choices(limit_choices_to: Optional[Union[List[str], Tuple[str, ...], Set[str]]] = None, sort_by_key: bool = False) → List[Tuple[str, str]][source]

Get currency choices.

List of choices in the following format:

[
    ("AMD", "Armenian Dram"),
    ("EUR", "Euro"),
]
valuta.utils.get_currency_choices_with_code(limit_choices_to: Optional[Union[List[str], Tuple[str, ...], Set[str]]] = None, sort_by_key: bool = False) → List[Tuple[str, str]][source]

Get currency choices with code.

List of choices in the following format:

[
    ("AMD", "Armenian Dram (AMD)"),
    ("EUR", "Euro (EUR)"),
]

Module contents