Postman - installation instructions
===================================

.. contents::

First, install dependencies
---------------------------

So far, the only dependency you will need in order to run postman is Python [1]_

Postman has been tested with python *2.7.x*, but it should work with versions
2.6.x too.

Please, refer to your operating system package system documentation to learn
more about how to install python.

Second, install Postman
-----------------------

Installing using pip
++++++++++++++++++++

You can install Postman using pip [2]_::

  pip install -e https://bitbucket.org/codigo23/postman#egg=postman

.. note::

   Postman has not been recorded/uploaded to pypi [3]_ yet, so, in order
   to install it using pip you will have to provide the URL for the public
   Postman repo.

Installing using easy_install
+++++++++++++++++++++++++++++

You can not install Postman using easy_install [4]_ yet (until we do
record/upload it to pypi)

Installing inside a virtualenv
++++++++++++++++++++++++++++++

You can install Postman inside a virtualenv [5]_. Just create a virtualenv::

  virtualenv /path/to/your/env

Then activate it::

  source /path/to/your/env/bin/activate

.. note::

   If your shell is **csh**/**tcsh** remember you have to activate the 
   environment this way::

     source /path/to/your/env/bin/activate.csh

And, once the environment has been activated, using pip to install Postman::

  env$ pip install -e https://bitbucket.org/codigo23/postman#egg=postman

Installing from sources
+++++++++++++++++++++++

Releases
********

There are no releases yet. You will have to install it from the repository.

From repository
***************

The source code of Postman is hosted in bitbucket [6]_. In order to grab
the latest sources you need Mercurial [7]_.

To get a copy of the sources, just *clone* the repository::

  hg clone https://bitbucket.org/codigo23/postman postman-repo

Then, go inside the *postman-repo* directory and run::

  python setup.py install

.. warning::

   If you want to install it *system-wide*, probably you will need *root*
   privileges (check your OS documentation to learn more about how to get
   *root* privileges - for example using sudo [8]_)

Setting up Postman
------------------

TBW

Running Postman
---------------

TBW

Running tests (developers only)
-------------------------------

TBW

.. [1] http://python.org
.. [2] http://www.pip-installer.org/en/latest/index.html
.. [3] http://pypi.python.org/pypi
.. [4] http://peak.telecommunity.com/DevCenter/EasyInstall
.. [5] http://www.virtualenv.org/en/latest/index.html
.. [6] https://bitbucket.org/codigo23/postman
.. [7] http://mercurial.selenic.com
.. [8] http://sudo.ws