Installation

Stable Version

We recommend install python-ari with pip. At the command line:

pip install python-ari

Development (Unstable) Version

Note

This document originates from the OpenStack project. Since we also use the same toolset for testing, we can also use some of their documentaion. We have obviously made changes that only affect our project but we credit the OpenStack project for the original [1].

If you want to run the latest development version of python-ari you will need to install git and clone the repo from GitHub:

git clone https://github.com/kickstandproject/python-ari
cd python-ari

Installing and using the virtualenv

To install the virtual environment you simply run the following:

python tools/install_venv.py

This will install all of the Python packages listed in the requirements.txt file into your virtualenv. There will also be some additional packages (pip, distribute, greenlet) that are installed by the tools/install_venv.py file into the virutalenv.

If all goes well, you should get a message something like this:

Python-ari development environment setup is complete.

Python-ari development uses virtualenv to track and manage Python
dependencies while in development and testing.

To activate the python-ari virtualenv for the extent of your current shell
session you can run:

$ source /home/pabelanger/git/pabelanger/python-ari/.venv/bin/activate

Or, if you prefer, you can run commands in the virtualenv on a case by case
basis by running:

$ /home/pabelanger/git/pabelanger/python-ari/tools/with_venv.sh <your command>

Also, make test will automatically use the virtualenv.

To activate the python-ari virtualenv for the extent of your current shell session you can run:

source .venv/bin/activate

[1]	See http://docs.openstack.org/developer/nova/devref/development.environment.html