ccy 0.5.1
Python currencies
Python module for currencies. The module compiles a dictionary of currency objects containing information useful in financial analysis.
Not all currencies in the world are supported yet. You are welcome to join and add more.
Currency object
To use it:
>>> import ccy
>>> c = ccy.currency('aud')
>>> c.printinfo()
code: AUD
twolettercode: AD
roundoff: 4
default_country: AU
isonumber: 036
order: 3
name: Australian Dollar
>>> c.as_cross()
'AUDUSD'
>>> c.as_cross('/')
'AUD/USD'
a currency object has the following properties:
- code: the [http://en.wikipedia.org/wiki/ISO_4217 ISO 4217] code.
- twolettercode: two letter code (can't remeber the ISO number). Very useful for financial data providers such as Bloomberg.
- default_country: the default ISO 3166-1 alpha-2 country code for the currency.
- isonumber: the ISO 4217 number.
- name: the name of the currency.
- order: default ordering in currency pairs (more of this below).
- roundoff: number of decimal places
Some shortcuts:
>>> import ccy
>>> ccy.cross('aud')
'AUDUSD'
>>> ccy.crossover('eur')
'EUR/USD'
>>> ccy.crossover('chf')
'USD/CHF'
Note, the Swiss franc cross is represented as 'USD/CHF', while the Aussie Dollar and Euro crosses are represented with the USD as denominator. This is the market convention which is handled by the order property of a currency object.
Country information
To use it:
>>> import ccy
>>> c = ccy.country('us')
>>> c
'United States'
>>> ccy.countryccy('us')
'USD'
Not all the country codes are standard [http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ISO 3166-1 alpha-2]. There is a function for adding extra pseudo-countries:
import ccy
ccy.set_new_country('EU','EUR','Eurozone')
Set a new country with code 'EU', currency 'EUR' named 'Eurozone'. This pseudo country is set in the library already.
Requirements
- Python 2.6 or above, including Python 3
- pytz for Countries information.
Installation
This library works for Python 2.6 and higher, including Python 3.
Using easy_install:
easy_install ccy
Using pip:
pip install ccy
From source:
python setup.py install
It requires the pytz package.
| File | Type | Py Version | Uploaded on | Size | # downloads |
|---|---|---|---|---|---|
| ccy-0.5.1.tar.gz (md5) | Source | 2011-06-16 | 55KB | 713 | |
- Author: Luca Sbardella
- Home Page: http://code.google.com/p/ccy/
- License: BSD
-
Categories
- Development Status :: 4 - Beta
- Environment :: Plugins
- Intended Audience :: Developers
- Intended Audience :: Financial and Insurance Industry
- License :: OSI Approved :: BSD License
- Operating System :: OS Independent
- Programming Language :: Python :: 2.6
- Programming Language :: Python :: 2.7
- Programming Language :: Python :: 3.0
- Programming Language :: Python :: 3.1
- Programming Language :: Python :: 3.2
- Topic :: Office/Business :: Financial
- Topic :: Utilities
- Package Index Owner: lsbardel
- DOAP record: ccy-0.5.1.xml
