Installing

Note

Using Virtualenv is recommended when evaluating or running locally.

Installation is simple with pip:

pip install clique

Installing from source

You can also build and install manually from the source for more control.

First obtain a copy of the source by either downloading or cloning the public repository:

git clone git@gitlab.com:4degrees/clique.git

Then build and install the package into your current Python environment:

pip install .

If actively developing, perform an editable install instead. This will link the installed package to the project source reflecting any local changes made:

pip install -e .

Note

To also enable building documentation and running tests from source, use the following command to ensure that the relevant ‘extra’ packages are installed:

pip install -e ".[dev]"

Alternatively, just build locally and manage yourself:

python setup.py build

Building documentation from source

Ensure the ‘extra’ packages required for building the documentation are installed:

pip install -e ".[doc]"

Then build the documentation:

python setup.py build_sphinx

View the result in your browser:

file:///path/to/clique/build/doc/html/index.html

Running tests against the source

Ensure the ‘extra’ packages required for running the tests are installed:

pip install -e ".[test]"

Then run the tests as follows:

python setup.py -q test

A coverage report can also be generated when running tests:

python setup.py -q test --addopts "--cov --cov-report=html"

View the generated report at:

file:///path/to/clique/htmlcov/index.html