openexchangerate

OpenExchangeRates API client for Python 3.7+, worldwide exchange prices + Bitcoin price + Gold price. Can be used as context manager or iterator. Namedtuple, dict and HTML outputs. No dependencies. Float or Decimal. Optional Timeout. Optional round. 1 file.

• Example HTML output from OpenExchangeRates(api_key).latest().html

Install

pip install openexchangerate

Use

from openexchangerate import OpenExchangeRates

client = OpenExchangeRates(api_key="21e7c27676972")

client.latest().namedtuple      # .dict for Dictionary, .html for HTML.
client.currencies().namedtuple  # .frozendict for Inmutable Dictionary.

for name, price in client:  # Iterator support.
    print(name, price)

with client as prices:  # Context Manager support.
    print(prices.frozendict)

Tests

python -m unittest --verbose --locals tests.TestOpenExchangeRates

• Test Templates.

Description of OpenExchangeRates

OpenExchangeRates

openexchangerate.OpenExchangeRates(api_key: str, timeout: int=60, use_float: bool=True, round_float: bool=True, base: str='USD', local_base: str=None)

Description: Returns namedtuple or dict with current international exchange prices and Bitcoin price.

Arguments:

• api_key Your API Key, you can get one API Key for Free, string type.
• timeout Timeout on Seconds for network connections, integer type, optional.
• use_float True for float, False for decimal.Decimal, boolean type, optional.
• round_float True to round floats to 2 decimals, using round(float, 2), boolean type, optional.
• base Base currency, Only for Pay accounts!, defaults to "USD", string type, optional.
• local_base Local Base currency, for Free accounts, to calculate values locally (offline), string type, optional.

Keyword Arguments: None.

Returns: collections.namedtuple.

Dependencies: None.

Source Code file: https://github.com/juancarlospaco/openexchangerate/blob/master/openexchangerate.py

State	OS	Description
✅	Linux	Works Ok
✅	Os X	Works Ok
✅	Windows	Works Ok

Usage Example:

>>> from openexchangerate import OpenExchangeRates
>>> OpenExchangeRates("21e7c27676972").latest()

Speed

Maximum performance for advanced Linux users.

sudo pip install cython

Cython basically translates Python 3 to C and then Compiles C to Binary, then you can import the generated *.so module as a normal Python module.

Its 100% Optional, but recommend. We check that Cython Compiles on Travis.

You dont have to learn anything about Cython, it just works automatically. The Packages on PyPi dont have any *.c, *.cpp, *.pyc, *.so.

Cython is used by lots of projects and companies. Please check Cython documentation for more info.

Contributors:

• Please Star this Repo on Github !, it helps to show up faster on searchs.
• Help and more Help and Interactive Quick Git Tutorial.
• English is the primary default spoken language, unless explicitly stated otherwise (eg. Dont send Translation Pull Request)
• Pull Requests for working passing unittests welcomed.

Licence:

• GNU GPL Latest Version and GNU LGPL Latest Version and any Licence YOU Request via Bug Report.

Ethics and Humanism Policy:

• Religions is not allowed. Contributing means you agree with the COC.