money 1.3.0

安装

安装最新版本：

pip install money

对于区域感知格式，还要安装最新版本的Babel（需要 2.2 或更高版本）：

pip install babel

用法

>>> from money import Money
>>> m = Money(amount='2.22', currency='EUR')
>>> m
EUR 2.22

金额可以是十进制中的任何有效值。十进制（值）和货币应该是三个字母的货币代码。Money 对象按照惯例是不可变的并且是可散列的。创建后，您可以使用只读属性amount (decimal.Decimal) 和currency (str) 来访问其内部组件：

>>> m = Money(2, 'USD')
>>> m.amount
Decimal('2')
>>> m.currency
'USD'

Money 模拟数字类型，您可以在货币对象之间应用大多数算术和比较运算符，以及整数 (int) 和十进制数 (decimal.Decimal) 的加法、减法和除法：

>>> m = Money('2.22', 'EUR')
>>> m / 2
EUR 1.11
>>> m + Money('7.77', 'EUR')
EUR 9.99

更正式地说，AAA和BBB是不同的货币：

不直接支持带有浮点数的算术运算。如果需要对浮点数进行操作，则必须先将浮点数转换为Decimal，或者将Money 对象转换为浮点数（即float(m)）。请注意浮点运算的问题和限制。

class EUR(Money):
    def __init__(self, amount='0'):
        super().__init__(amount=amount, currency='EUR')

price = EUR('9.99')

格式化

Money 对象默认使用 en_US 格式和货币代码打印。

>>> m = Money('1234.567', 'EUR')
>>> str(m)
'EUR 1,234.57'

使用format(locale=LC_NUMERIC, pattern=None, currency_digits=True, format_type='standard')进行带货币扩展的区域感知格式化。format()依赖于babel.numbers.format_currency()，并且需要安装 Babel 2.2 或更高版本。

>>> m = Money('1234.567', 'USD')
>>> m.format('en_US')
'$1,234.57'
>>> m.format('es_ES')
'1.234,57\xa0$'

字符\xa0是一个 unicode 不间断空格。如果没有传递语言环境，Babel 将使用您系统的语言环境。您还可以为 format() 提供特定模式：

>>> m = Money('-1234.567', 'USD')
>>> # Regular US format:
>>> m.format('en_US', '¤#,##0.00')
'-$1,234.57'
>>> # Custom negative format:
>>> m.format('en_US', '¤#,##0.00;<¤#,##0.00>')
'<$1,234.57>'
>>> # Spanish format, full currency name:
>>> m.format('es_ES', '#,##0.00 ¤¤¤')
'-1.234,57 dólares estadounidenses'
>>> # Same as above, but rounding (overriding currency natural format):
>>> m.format('es_ES', '#0 ¤¤¤', currency_digits=False)
'-1235 dólares estadounidenses'

有关格式化的更多详细信息，请参阅Babel docs on currency formatting。要了解有关格式化模式语法的更多信息，请查看Unicode TR35。

货币兑换

货币兑换通过“安装”实现抽象基类 ( abc ) money.exchange.BackendBase的后端类来工作。它的 API 通过money.xrates以及设置函数xrates.install(pythonpath)、xrates.uninstall()和xrates.backend_name 公开。

包括一个简单的概念验证后端money.exchange.SimpleBackend：

from decimal import Decimal
from money import Money, xrates

xrates.install('money.exchange.SimpleBackend')
xrates.base = 'USD'
xrates.setrate('AAA', Decimal('2'))
xrates.setrate('BBB', Decimal('8'))

a = Money(1, 'AAA')
b = Money(1, 'BBB')

assert a.to('BBB') == Money('4', 'BBB')
assert b.to('AAA') == Money('0.25', 'AAA')
assert a + b.to('AAA') == Money('1.25', 'AAA')

XMoney

您可以使用money.XMoney（Money 的子类），在加、减、除货币对象（+、+=、-、-=、/、//）时进行自动货币转换。这在聚合大量具有异构货币的货币对象时很有用。最左边对象的货币具有优先权。

from money import XMoney

# Register backend and rates as above...

a = XMoney(1, 'AAA')
b = XMoney(1, 'BBB')

assert sum([a, b]) == XMoney('1.25', 'AAA')

例外

在money.exceptions中找到。

金钱异常（异常）

所有异常的基类。

货币不匹配（MoneyException，ValueError）

混合不同货币时抛出，例如Money(2, 'EUR') + Money(2, 'USD')。Money 对象必须首先转换为相同的货币，或者可以使用 XMoney 进行自动转换。

InvalidOperandType（MoneyException，TypeError）

尝试无效操作时抛出，例如货币对象之间的乘法。

ExchangeError（MoneyException）

交换异常的基类。

ExchangeBackendNotInstalled(ExchangeError)

如果尝试转换，但没有可用的后端，则抛出此异常。

ExchangeRateNotFound(ExchangeError)

安装的后端未能在原始货币和目标货币之间提供合适的汇率。

Python版本之间的差异

设计决策

货币中有几个设计决策与当前可用的货币类实现不同：

贡献

欢迎投稿。您可以使用常规的 github 机制。

为了向前兼容，并考虑到包的小尺寸，Python 2.7 在src-py2的不同源“分支”中得到支持。

要测试您的更改，您将需要tox和 python 2.7、3.4 和 3.5。只需 cd 到包根目录（通过 setup.py）并运行tox。

执照

money 是根据MIT 许可证发布的，可以在文件LICENSE中找到。