https://github.com/mirumee/django-prices-openexchangerates
openexchangerates.org support for django-prices
https://github.com/mirumee/django-prices-openexchangerates
currencies currency django django-prices exchange money openexchangerates price python
Last synced: 3 months ago
JSON representation
openexchangerates.org support for django-prices
- Host: GitHub
- URL: https://github.com/mirumee/django-prices-openexchangerates
- Owner: mirumee
- License: bsd-3-clause
- Created: 2015-01-27T10:10:35.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-08-29T13:45:42.000Z (about 3 years ago)
- Last Synced: 2025-06-24T00:11:49.083Z (4 months ago)
- Topics: currencies, currency, django, django-prices, exchange, money, openexchangerates, price, python
- Language: Python
- Size: 121 KB
- Stars: 33
- Watchers: 23
- Forks: 15
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# openexchangerates.org support for `django-prices`
```python
from prices import Money
from django_prices_openexchangerates import exchange_currency
converted_price = exchange_currency(Money(10, currency='USD'), 'EUR')
print(converted_price)
# Money('8.84040', currency='EUR')
```
It will also create additional steps if it cannot convert directly:
```python
from prices import Money
from django_prices_openexchangerates import exchange_currency
converted_price = exchange_currency(Money(10, currency='GBP'), 'EUR')
print(converted_price)
# Money('13.31313588062401085236264978', currency='EUR')
```
The `exchange_currency` supports `Money`, `TaxedMoney`, `MoneyRange` and `TaxedMoneyRange`.
Template filters can be used with `django-prices` to convert currency, round amounts and display localized amounts in templates:
```html+django
{% load prices_i18n %}
{% load prices_multicurrency %}
Price: {{ foo.price.gross|in_currency:'USD'|amount }} ({{ foo.price.net|in_currency:'USD'|amount }} + {{ foo.price.tax|in_currency:'USD'|amount }} tax)
```
Installation
==============
First install the package:
```
pip install django-prices-openexchangerates
```
Then add `'django_prices_openexchangerates'` to your `INSTALLED_APPS`.
Set following settings in your project's settings:
* `OPENEXCHANGERATES_API_KEY`
* `OPENEXCHANGERATES_BASE_CURRENCY` (defaults to `'USD'`, only premium accounts support other bases)
Use your admin console to create `ConversionRate` objects for each currency that you want to support.
Updating exchange rates
=======================
Fetch current rates from API with `./manage.py update_exchange_rates`
Schedule this task in cron job or in celery, to be always up to date with exchange rates
You can use `--all` flag in above command, to create exchange rates automatically for all available currencies.