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, use 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