pricing 1.0.1

基本的

>>> from pricing import Price
... Price('2.22', 'USD')
EUR 2.22

>>> Price('2.34223434', 'BTC')
BTC 2.34223434

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

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

格式化

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

>>> m.format()
'€1,234.57'

支付 URI

创建 BIP21 和 EIP681 兼容的支付 URI。

>>> from pricing.uris import BIP21PaymentURI
... BIP21PaymentURI(
... 'bitcoin',
... address='19kxPokCjD6tUU3sHaLZgEQBkRsCTBt3jj',
... amount='4.32345').to_uri()
'bitcoin:19kxPokCjD6tUU3sHaLZgEQBkRsCTBt3jj?amount=4.32345'

>>> from pricing.uris import EIP681PaymentURI
... EIP681PaymentURI(
... 'ethereum',
... address='077a7506b69e37e4f6852577190f04a35df9a36c',
... value='4.32345').to_uri()
'ethereum:0x077a7506b69e37e4f6852577190f04a35df9a36c?value=4.32345'

货币兑换

货币兑换通过“安装”一个实现IExchangeBackend接口的后端类来工作。

X价格

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

from pricing import XPrice

# Register backend and rates as above...
a = XPrice(1, 'AAA')
b = XPrice(1, 'BBB')

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

扩展和定制

您可以使用 ZCML 配置自定义的 currencyFormats 和 exchange，创建一个名为currency.zcml的新文件，然后按照下面的示例进行配置。

<configure
    xmlns:zope=<s>"http://namespaces.zope.org/zope"</s>
    xmlns=<s>"http://namespaces.zope.org/currency"</s>>

    <zope:include package=<s>"pricing"</s> file=<s>"currency-meta.zcml"</s> />

    <currency default=<s>"USD"</s>>
        <currencyFormat
            name=<s>"bitcoin"</s>
            code=<s>"BTC"</s>
            symbol=<s>"₿"</s>
            format=<s>"¤#,##0.########"</s>
            currency_digits=<s>"false"</s>
            decimal_quantization=<s>"true"</s> />
        <currencyFormat
            name=<s>"litecoin"</s>
            code=<s>"LTC"</s>
            symbol=<s>"Ł"</s>
            format=<s>"¤#,##0.########"</s>
            currency_digits=<s>"false"</s>
            decimal_quantization=<s>"true"</s> />
        <currencyFormat
            name=<s>"ether"</s>
            code=<s>"ETH"</s>
            symbol=<s>"Ξ"</s>
            format=<s>"¤#,##0.##################"</s>
            currency_digits=<s>"false"</s>
            decimal_quantization=<s>"true"</s> />

        <exchange
            component=<s>"pricing.exchange.Exchange"</s>
            backend=<s>"pricing.exchange.CoinBaseBackend"</s>
            base=<s>"USD"</s> />
    </currency>

</configure>

然后在您的configure.zcml文件中包含currency.zcml ：

<include file=<s>"currency.zcml"</s> />

字段

包括zope.schema和基于attrs的类的自定义字段。结帐money.fields。

等级制度

• 价格异常

  • 货币错配

  • 无效操作数类型

  • 交换错误

    • ExchangeBackendNotInstalled

    • ExchangeRateNotFound