Metadata-Version: 2.1
Name: dj-currencies3
Version: 1.0.1
Summary: A reusable django app that provides locally updated exchange rates to your app
Home-page: https://github.com/mthipparthi/dj-currencies
Author: Mahesh
Author-email: mahesh.thipparthi@gmail.com
License: MIT
Description: 
        
        .. image:: https://travis-ci.org/brightwrite/dj-currencies.svg?branch=master
            :target: https://travis-ci.org/brightwrite/dj-currencies
        
        
        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`:
        
        .. code-block:: python
        
            INSTALLED_APPS = (
                ...
                'dj_currencies',
                ...
            )
        
        Settings
        ========
        
        
        .. code-block:: python
        
            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
        
        .. NOTE::
           You will need to have at least "OPENEXCHANGE_APP_ID" configured if you use **OpenExchangeBackend**
        
        
        
        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.
        
Keywords: dj-currencies3
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django :: 3.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
