Metadata-Version: 2.0
Name: openexchangerates
Version: 0.0.4
Summary: openexchangerates.org python API client
Home-page: https://github.com/metglobal/openexchangerates
Author: Metglobal
Author-email: kadir.pekel@metglobal.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: requests

=================
openexchangerates
=================

This is a simple python client implementation of https://openexchangerates.org
web services.

Install
-------

openexchangerates is avaiable on pypi repositories. Just simply install
by using ``easy_install`` or ``pip``::

    $ pip install openexchangerates

Usage
-----

First of all, you have to sign up the service for an API key by visiting
https://openexchangerates.org

Then it is a matter of cake to start using the service::

    >>> from openexchangerates import OpenExchangeRatesClient
    >>> client = OpenExchangeRatesClient('<YOUR_API_KEY>')
    >>> client.currencies()
    {'AED': 'United Arab Emirates Dirham',
    'AFN': 'Afghan Afghani',
    'ALL': 'Albanian Lek',
    'AMD': 'Armenian Dram',
    'ANG': 'Netherlands Antillean Guilder',
    'AOA': 'Angolan Kwanza',
    'ARS': 'Argentine Peso',
    'AUD': 'Australian Dollar',
    ...

    >>> client.latest()
    {'base': 'USD',
    'disclaimer': '<disclaimer>',
    'license': '<license>',
    'rates': {'AED': 3.672701,
        'AFN': 51.621833,
        'ALL': 104.032,
        'AMD': 406.489997,
        'ANG': 1.7888,
        'AOA': 95.936967,
        'ARS': 4.995484,
        'AUD': 0.966637,
        ...

You are also free to select base currency (Supported by non-free licenses)::

    >>> client.latest(base='GBP')
    {'base': 'GBP',
    'disclaimer': '<disclaimer>',
    'license': '<license>',
    'rates': {'AED': 3.672701,
        'AFN': 51.621833,
        'ALL': 104.032,
        'AMD': 406.489997,
        'ANG': 1.7888,
        'AOA': 95.936967,
        'ARS': 4.995484,
        'AUD': 0.966637,
        ...


