Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-exchange-0.5.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

django_exchange-0.5-py2.py3-none-any.whl (12.3 kB view details)

Uploaded Python 2Python 3

File details

Details for the file django-exchange-0.5.tar.gz.

File metadata

  • Download URL: django-exchange-0.5.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-exchange-0.5.tar.gz
Algorithm Hash digest
SHA256 92c0877c5aa4cb59a7b1e190210d6a49200ee4280100a90b81ebcabfa1c9164e
MD5 e5eaa2fa55915dc400213be507a4b9d7
BLAKE2b-256 1ddc5bed2c6009c64e47a7a797df47c1a69019705ea87af2469e8473a069caf9

See more details on using hashes here.

File details

Details for the file django_exchange-0.5-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_exchange-0.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ff8001e28e66d0e15fdf2ef88c34c47780958c6af4844c1637bdcfd6e374ae55
MD5 f5b2b5d7673ba24edd4b22b949e2ebe8
BLAKE2b-256 5d981159df03ed051c2ca3781373ba21b232394da783ce3262bb74a0e3b7a4df

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page