Metadata-Version: 2.1
Name: django-money-rates
Version: 0.3.1
Summary: Currency conversion for money
Home-page: https://github.com/evonove/django-money-rates
Author: Federico Frenguelli
Author-email: synasius@gmail.com
License: BSD
Keywords: django-money-rates
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
License-File: LICENSE
License-File: AUTHORS.rst

=============================
django-money-rates
=============================

.. image:: https://badge.fury.io/py/django-money-rates.png
    :target: http://badge.fury.io/py/django-money-rates
    
.. image:: https://travis-ci.org/evonove/django-money-rates.png?branch=master
        :target: https://travis-ci.org/evonove/django-money-rates


.. image:: https://coveralls.io/repos/evonove/django-money-rates/badge.png
  :target: https://coveralls.io/r/evonove/django-money-rates

.. image:: https://pypip.in/d/django-money-rates/badge.png
        :target: https://crate.io/packages/django-money-rates?version=latest


Currency conversion for money

Documentation
-------------

The full documentation is at http://django-money-rates.rtfd.org.

Quickstart
----------

Install django-money-rates::

    pip install django-money-rates

Then use it in a project::

    import djmoney_rates

In order to save exchange rates to your database, add `djmoney_rates` to your INSTALLED_APPS in your project's settings::

    INSTALLED_APPS = (
        ...
        'djmoney_rates',
        ...
    )

Setup the Open Exchange Rates backend
-------------------------------------

Open an account at https://openexchangerates.org/ if you don't have one already. Then, add this to your project's settings::

    DJANGO_MONEY_RATES = {
        'DEFAULT_BACKEND': 'djmoney_rates.backends.OpenExchangeBackend',
        'OPENEXCHANGE_URL': 'http://openexchangerates.org/api/latest.json',
        'OPENEXCHANGE_APP_ID': 'YOUR APP ID HERE',
        'OPENEXCHANGE_BASE_CURRENCY': 'USD',
    }

For more information on the Open Exchange Rates API, see https://openexchangerates.org/

Pull the latest Exchange Rates
------------------------------

Once your backend is setup, get the latest exchange rates::

    $ ./manage.py update_rates

Convert from one currency to another
------------------------------------

Here's an example of converting 10 Euros to Brazilian Reais:

.. code-block:: python

    from moneyed import Money
    from djmoney_rates.utils import convert_money
    brl_money = convert_money(10, "EUR", "BRL")

Features
--------

* Convert money from one currency to another with an easy to use API.

TODO List
---------

* Add money converter wrapper for util's `convert_money` function.
* Add celery periodic task for getting daily exchange rates.




History
-------

0.3.0 (2013-12-30)
++++++++++++++++++

* `convert_money` utility function now returns moneyed.Money instances

0.1.0 (2013-10-16)
++++++++++++++++++

* First release on PyPI.
