Skip to main content

A reusable django app that provides locally updated exchange rates to your app

Project description

https://travis-ci.org/brightwrite/dj-currencies.svg?branch=master

Documentation

The full documentation is at https://dj-currencies.readthedocs.io.

Quickstart

version 1.0.0 supports Django 3+ only

For Django 2 support, please use version 0.1.2

Install djcurrencies:

pip install dj-currencies

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'dj_currencies',
    ...
)

Settings

DJANGO_CURRENCIES = {
    'DEFAULT_BACKEND': 'djmoney_rates.backends.OpenExchangeBackend',
    'OPENEXCHANGE_APP_ID': '',
    'BASE_CURRENCIES': ['USD'],
    'MAX_CACHE_DAYS': 7
}

DEFAULT_BACKEND: The selected backend to sync exchange rates

OPENEXCHANGE_APP_ID: Must be configured if you use OpenExchangeBackend

BASE_CURRENCIES: A list of base currencies to use. At the time of this version, you will only be able to convert currency from any one of the base currency to target currency.

MAX_CACHE_DAYS: Only use the cache within this time limit. If exchange rates was not synced within the time frame, an exception will thrown

Features

  • [open exchange rates](openexchangerates.org) integration

  • Extensible backend design, hook your own exchange rate sources

  • Multi base currencies support, no double conversion to lose precision

  • Store historical exchange rates

  • offline currency conversion

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ python runtests.py

History

0.0.1 (2018-04-23)

  • First release on PyPI.

1.0.1 (2020-03-09)

  • Added Django 3.1 Support.

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

dj-currencies-1.0.1.tar.gz (10.0 kB view hashes)

Uploaded Source

Supported by

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