============
Installation
============

Development
-----------

If you want to develop for txSpore or use the latest code we're working on, you
can install from the sources. You'll need bzr installed, and then just do the
following::

    $ bzr branch lp:txspore
    $ cd txspore
    $ sudo python setup.py install


Easy Install
------------

You can use the setuptools easy_install script to get txSpore on your system::

    $ sudo easy_install txSpore


Manual Download
---------------

You can manually download the source tarball from the Python Package Index by
visiting the following URL:

    http://pypi.python.org/pypi/txSpore/

You'll need to untar and gunzip the source, cd into the source directory, and
then you can do the usual::

    $ sudo python setup.py install


Checking the Source
-------------------

Once installed, as long as you have Twisted installed on your system and the
trial script in your PATH, you can test the source code by executing this
anywhere::

    $ trial txspore

That will run the test suite and report on the success and failure of any unit
tests.
