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_exchange_rates
If you want to use you own service provider, you should consider implementing exchange.adapters.BaseAdapter class and pass you implementation class path as an argument to update_exchange_rates command:
$ python manage.py update_exchange_rates -c myproj.providers.MyProvider
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') >>> my_price.convert('YEN') <Price (4678.50 YEN)>
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
Built Distribution
Hashes for django_exchange-0.6.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a9b36f4401bf2c0d36cd616597e0d85b178081839ff12201fc7bbe5cfa31b624 |
|
MD5 | c18a445b9424d6e49c413403eb3890e5 |
|
BLAKE2b-256 | 4cead4f259069dd09b6492e778ec330f0b367b1f6a78bd4e41aad8b1b80a1eb5 |