CNB Exchange Rate

Python lib that downloads exchange rates from the Czech National Bank. Released under MIT License (see the LICENSE file).

Installation

If you have downloaded the source code:

python setup.py install

or if you want to obtain a copy from the Pypi repository:

pip install cnb-exchange-rate

Both commands will install the required package dependencies. The code is available on GitHub, which can be browsed at github or cloned by running

git clone git://github.com/stepansojka/cnb-exchange-rate

Usage

To import import the library:

>>> import cnb_exchange_rate

The rates can be obtained be obtained using:

>>> import datetime
>>> cnb_exchange_rate.daily_rate('EUR', datetime.date(2015, 1, 20))
27.845

>>> cnb_exchange_rate.monthly_rate('EUR', 2015, 1)
27.895

>>> cnb_exchange_rate.quarterly_rate('EUR', 2014, 4)
27.624

>>> cnb_exchange_rate.monthly_cumulative_rate('EUR', 2014, 6)
27.444

Running Tests

The easiest way to run test is by using tox, a wrapper around virtualenv. It will take care of setting up environnements with the proper dependencies installed and execute test commands. To install it simply:

pip install tox

Then run:

tox

To run the tests with fake CNB server (faster execution), run:

tox -- --fake