Download and Install
====================

The pybctc project is hosted at <http://bitbucket.org/kc/pybctc>.
Releases are made via the Python Package Index at
<http://pypi.python.org/pypi/pybctc>.  Online documentation is made
available at <http://packages.python.org/pybctc>.

Requirements
------------
* *Python 2.4 or better* - Available at <http://python.org/download>
  (2009-11-25).

* *pytz* - "World timezone definitions, modern and historical".
  Available at <http://pypi.python.org/pypi/pytz> (2009-11-14).

* *xlrd* - "Library for developers to extract data from Microsoft Excel
  (tm) spreadsheet files".  Available at
  <http://pypi.python.org/pypi/xlrd/0.5.2> (2010-02-20).


Install
-------

Extract the archive, enter the recovered directory and type:

``python setup.py install``


Known Incompatibilities
-----------------------

* *Python <= 2.3* - Fails because of requirement for decimal module
  introduced in Python 2.4.

* *Python 3* - *pybctc* uses two underlying libraries, pytz and xlrd,
  that have no Python 3 version available (2010-02-20).  When these
  underlying libraries support Python 3 the *pybctc* library can quickly
  be made to work.