language: python

python:

- 2.6

- 2.7

- 3.1

- 3.2

install:

- pip install --use-mirrors nose numpy

- if [[ $TRAVIS_PYTHON_VERSION == '2.'* ]]; then pip install --use-mirrors PIL; fi

- python setup.py install

script:

- mkdir ../foo

- cd ../foo

- python ../matplotlib/tests.py

Using tox

`Tox <http://tox.testrun.org/>`_ is a tool for running tests against multiple

Python environments, including multiple versions of Python (e.g.: 2.6, 2.7,

3.2, etc.) and even different Python implementations altogether (e.g.: CPython,

PyPy, Jython, etc.)

Testing all 4 versions of Python (2.6, 2.7, 3.1, and 3.2) requires having four

versions of Python installed on your system and on the PATH. Depending on your

operating system, you may want to use your package manager (such as apt-get,

yum or MacPorts) to do this, or use `pythonbrew

<https://github.com/utahta/pythonbrew>`_.

tox makes it easy to determine if your working copy introduced any regressions

before submitting a pull request. Here's how to use it:

.. code-block:: bash

You can also run tox on a subset of environments:

.. code-block:: bash

Tox processes everything serially so it can take a long time to test several

environments. To speed it up, you might try using a new, parallelized version

of tox called ``detox``. Give this a try:

.. code-block:: bash

Tox is configured using a file called ``tox.ini``. You may need to edit this

file if you want to add new environments to test (e.g.: ``py33``) or if you

want to tweak the dependencies or the way the tests are run. For more info on

the ``tox.ini`` file, see the `Tox Configuration Specification

<http://tox.testrun.org/latest/config.html>`_.

Using Travis CI

`Travis CI <http://travis-ci.org/>`_ is a hosted CI system "in the cloud".

Travis is configured to receive notifications of new commits to GitHub repos

(via GitHub "service hooks") and to run builds or tests when it sees these new

commits. It looks for a YAML file called ``.travis.yml`` in the root of the

repository to see how to test the project.

Travis CI is already enabled for the `main matplotlib GitHub repository

<https://github.com/matplotlib/matplotlib/>`_ -- for example, see `its Travis

page <http://travis-ci.org/#!/matplotlib/matplotlib>`_.

If you want to enable Travis CI for your personal matplotlib GitHub repo,

simply enable the repo to use Travis CI in either the Travis CI UI or the

GitHub UI (Admin | Service Hooks). For details, see `the Travis CI Getting

Started page <http://about.travis-ci.org/docs/user/getting-started/>`_.

Once this is configured, you can see the Travis CI results at

http://travis-ci.org/#!/your_GitHub_user_name/matplotlib -- here's `an example

<http://travis-ci.org/#!/msabramo/matplotlib>`_.

envlist = py26, py27, py31, py32

changedir = /tmp

commands =

sh -c 'rm -f $HOME/.matplotlib/fontList*'

{envpython} {toxinidir}/tests.py

deps =

nose

numpy