Installing Ripyl

The Ripyl library will work on all platforms that support a Python interpreter. The following is a brief guide to installing the ripyl library. You will generally need administrative or super user (root) access to perform the installation as indicated below.

Requirements

Ripyl depends on the following:
Optional libraries are:

You should ensure the dependencies are installed and functioning properly on your platform before attempting to install Ripyl.

Installation

Download the compressed source archive for your platform and extract its contents. On all platforms you can install from a command prompt. From an administrative or root shell type the following command from the directory containing the decompressed archive.

> python setup.py install

This will install a copy of Ripyl library to the Python site-packages or dist-packages directory and enable the ripyl_demo script.

On some Unix platforms you may need to install to your home directory or use root access through sudo.

> python setup.py install --home=~

> sudo python setup.py install
[sudo] password for user: *****

Cython

The Ripyl library has been designed with optional Cython support. By default the installation script will detect and enable Cython if it is present. You can force Cython support off by passing the --without-cython argument to setup.py. The status of the Cython configuration is written into a ripyl.cfg file at build time. You can enable or disable the use of Cython after Ripyl is installed by setting the RIPYL_CYTHON environment variable to a true or false value as desired:

> export RIPYL_CYTHON=1

Testing

You can run the Ripyl library test suite using the enhanced unittest from Python 2.7 or greater. All tests are run from the base directory of the source distribution (where setup.py is located)

> python -m unittest discover

This will find the test suites in the test directory and run them.