https://github.com/mirumee/prices
Python price handling for humans.
https://github.com/mirumee/prices
currencies currency e-commerce gross money net prices python
Last synced: 3 months ago
JSON representation
Python price handling for humans.
- Host: GitHub
- URL: https://github.com/mirumee/prices
- Owner: mirumee
- License: other
- Created: 2012-09-11T21:20:38.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2022-10-07T12:55:57.000Z (almost 3 years ago)
- Last Synced: 2025-06-24T00:11:49.527Z (3 months ago)
- Topics: currencies, currency, e-commerce, gross, money, net, prices, python
- Language: Python
- Homepage:
- Size: 102 KB
- Stars: 268
- Watchers: 30
- Forks: 41
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Prices: Python price handling for humans
========================================
[](https://travis-ci.org/mirumee/prices) [](http://codecov.io/github/mirumee/prices?branch=master)
------
Money:
```python
from prices import Money
a = Money(10, 'USD')
a += Money(20, 'USD')
a.value
# Decimal('30')
a = a.quantize()
a.value
# Decimal('30.00')
a = Money('5.00', 'JPY')
a.quantize()
a.value
# Decimal('5')
```
Taxed money:
```python
from prices import Money, TaxedMoney
p = TaxedMoney(net=Money(20, 'EUR'), gross=Money(30, 'EUR'))
p.net
# Money('20', 'EUR')
p.gross
# Money('30', 'EUR')
p.tax
# Money('10', 'EUR')
p = p.quantize()
p.net
# Money('20.00', 'EUR')
```
Taxed ranges:
```python
from prices import Money, TaxedMoney, TaxedMoneyRange
price1 = TaxedMoney(Money(1, 'USD'), Money(1, 'USD'))
price2 = TaxedMoney(Money(10, 'USD'), Money(10, 'USD'))
pr = TaxedMoneyRange(price1, price2)
pr.min_price
# TaxedMoney(net=Money('1', 'USD'), gross=Money('1', 'USD'))
pr.max_price
# TaxedMoney(net=Money('10', 'USD'), gross=Money('10', 'USD'))
price3 = TaxedMoney(net=Money(5, 'USD'), gross=Money(5, 'USD'))
price3 in pr
# True
pr = pr.quantize()
pr.min_price.net
# Money('1.00', 'USD')
```
Taxes:
```python
from decimal import Decimal
from prices import Money, TaxedMoney, TaxedMoneyRange, flat_tax
p = TaxedMoney(Money('1.99', 'GBP'), Money('1.99', 'GBP'))
p = flat_tax(p, Decimal('0.23'))
p = p.quantize()
p.gross
# Money('2.45', 'GBP')
```
While protecting you from all sorts of mistakes:
```python
from prices import Money
Money(10, 'USD') < Money(15, 'GBP')
# ValueError: Cannot compare amounts in 'USD' and 'GBP'
```
```python
from prices import Money, TaxedMoney
price1 = TaxedMoney(Money(5, 'BTC'), Money(5, 'BTC'))
price2 = TaxedMoney(Money(7, 'INR'), Money(7, 'INR'))
price1 + price2
# ValueError: Cannot add amount in 'BTC' to 'INR'
```