Python Library for Tin Can API
Failed to load latest commit information.
docs Automatically pull version information for API docs from setup file Jun 2, 2015
examples Reformat code according to PEP8. Feb 19, 2015
test Further PEP8 support Feb 19, 2015
NOTICE Initial Travis CI setup Feb 5, 2015
setup.cfg Bump to 0.0.5 Jun 2, 2015

A Python library for implementing Tin Can API.

Build Status

For hosted API documentation, basic usage instructions, supported version listing, etc. visit the main project website at:

For more information about the Tin Can API visit:

Requires Python 2.7 or later.


TinCanPython requires Python 2.7 or later. Python 3 is not supported.

If you are installing from the Github repo, you will need to install aniso8601 and pytz (use sudo as necessary):

easy_install aniso8601 pytz

Recommended optimization

To speed up the timezone lookups, run:

pip unzip pytz


The preferred way to run the tests is from the command line.

Unix-like systems and Mac OS X

No preparation needed.


Make sure that your Python installation allows you to run python from the command line. If not:

  1. Run the Python installer again.
  2. Choose "Change Python" from the list.
  3. Include "Add python.exe to Path" in the install options. I.e. install everything.
  4. Click "Next," then "Finish."

Running the tests

It is possible to run all the tests in one go, or just run one part of the tests to verify a single part of TinCanPython. The tests are located in test/.

All the tests:

  1. cd to the test directory.
  2. Run


One of the tests:

  1. cd to the directory containing the test.
  2. Run


    (or whatever test you want to run)

A single test case of one of the tests:

  1. cd to the directory containing the test.
  2. Run

    python -m unittest remote_lrs_test.RemoteLRSTest.test_retrieve_statement

    Where "remote_lrs_test" is the test file, "RemoteLRSTest" is the class in that file, and "test_retrieve_statement" is the specific test case.

API doc generation

To automatically generate documentation, at the root of the repository run,

sphinx-apidoc -f -o ./docs/source/ tincan/

Then from the docs/ directory run,

make html

The docs will be output to docs/build/html/.

If you would like to change the names of each section, you can do so by modifying docs/source/tincan.rst.


To release to PyPI, first make sure that you have a PyPI account set up at (and at if you plan on using the test index). You will also need a .pypirc file in your home directory with the following contents.


index-servers =

[pypi] # authentication details for live PyPI
username: <username>
password: <password>

[pypitest] # authentication details for test PyPI
username: <username>
password: <password>

The pypitest contents of the .pypirc file are optional and are used for hosting to the test PyPI index.

Update to contain the correct release version and any other new information.

To test the register/upload, run the following commands in the repo directory:

python register -r pypitest
python sdist upload -r pypitest

You should get no errors and should be able to find this tincan version at

To register/upload to the live PyPI server, run the following commands in the repo directory:

python register -r pypi
python sdist upload -r pypi

The new module should be now be installable with pip or easy_install.

easy_install tincan


pip install tincan

Use sudo as necessary.