Installation guide

Installing from PyPI (easiest way)

* Works for all tested operating systems: Debian, Ubuntu, Mac OS X and Windows (may work in other ones)

If you have Setuptools and easy_install installed, you can install Pyccuracy by typing:

$ sudo easy_install pyccuracy

Installing from PyPI with PIP

This is the same as with easy_install, but PIP is a better python package manager than easy_install, because it features uninstalls, meaning you can always go back. Installing PIP is easy, just check this page http://pip.openplans.org/. You can always ‘sudo easy_install pip’.

$ pip install pyccuracy

or if you want to upgrade:

$ pip install pyccuracy --upgrade

Installing the .deb package

* Works for: Debian and Ubuntu Linux (may work in other Debian variants)

If you use a Debian-like Linux distribution, you can install our .deb packages available here by typing:

$ wget http://github.com/heynemann/pyccuracy/raw/master/releases/python-pyccuracy_X.deb
$ dpkg -i python-pyccuracy_X.deb

Using the source directly (team’s favorite)

* Works for all tested operating systems: Debian, Ubuntu, Mac OS X and Windows (may work in other ones)

We like to use the source because it’s very easy to get updates from the Github repository (as easy as typing “git pull”).

If you have Git installed, clone our Github repository and create a symbolic link in your site-packages directory (will be something like /usr/lib/python2.5/site-packages):

$ git clone git://github.com/heynemann/pyccuracy.git /path/to/create/clone/pyccuracy-master
$ ln -s /your/site-packages/pyccuracy /path/to/create/clone/pyccuracy-master/pyccuracy

You also need to create symbolic links to the command line tools in your bin directory (or any directory that is in your $PATH variable):

$ ln -s /bin/pyccuracy_console /path/to/your/clone/pyccuracy-master/pyccuracy/pyccuracy_console.py
$ ln -s /bin/pyccuracy_help /path/to/your/clone/pyccuracy-master/pyccuracy/pyccuracy_help.py

If you want to learn more about Github, check their excellent guides.

Checking if installation was successful

To check if installation was successful, type:

$ pyccuracy_console --help

You should see all the options available for pyccuracy_console command line tool.

Dependencies

Pyccuracy depends on the following Python libraries. You can install them using easy_install, apt (Debian/Ubuntu only), Mac Ports (Mac OS only) or your preferred package manager:

• lxml – Library to work with XML and HTML
• selenium – Python binding for Selenium

You will also need selenium-server.jar running in order to run Pyccuracy. To run, type:

$ java -jar selenium-server.jar