currency, exchange rates and conversions support for django
Project description
Currency, exchange rate and conversions support for django projects.
Install
django-exchange is available on pypi repositories so youre free to use pip or easy_install:
$ pip install django-exchange
Or you might want to install from source:
$ wget https://github.com/metglobal/django-exchange/archive/django-exchange-xxx.zip $ unzip django-exchange-xxx.zip $ cd django-exchange-xxx $ python setup.py install
Add exchange into your INSTALLED_APPS settings of your django project:
INSTALLED_APPS += [ 'exchange', ]
Don’t forget to sync your db to create corresponding database tables:
$ python manage.py syncdb
Populating Data
django-exchange supports populating currency and exchange rates using a service provider automatically. Currently it has built in support for openexchangerates.org service. It is only a matter of supplying an api key obtained from http://openexchangerates.org as django settings using the key OPENEXCHANGERATES_API_KEY:
OPENEXCHANGERATES_API_KEY = '<YOU_API_KEY_HERE>'
Now you can populate you currency and exchange rates magically by typing:
$ python manage.py update_rates
Quickstart
Currency conversions is dead easy. There are auxilaray methods helps you calculate conversions using populated exchange rates under exchange.conversions module.
Take a look at the example below:
>>> from exchange.conversion import Price, convert >>> my_price = Price(50, 'USD') >>> convert(my_price, 'EUR') <Price(value=Decimal('36.68585000'), currency='EUR')>
Documentation
Coming soon…
Todo
Convenient template tags
Django price field implementation supporting currency conversions
Easier api with convenient refaactorings
A few more builtin exchange rate provider
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-exchange-0.7.2.tar.gz
.
File metadata
- Download URL: django-exchange-0.7.2.tar.gz
- Upload date:
- Size: 11.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
97dc38c3ac0ea4226262047b3a0b2fb3e7cdd0a5900d9b123fac3c0da54039fc
|
|
MD5 |
723f75a8c11912b72a9203bd88f45d5a
|
|
BLAKE2b-256 |
96f8fc32a5fb0281c742f0205b8dda1dcc2d0be0876d888018d78b8ac74a68b5
|