Skip to content

Getting Started: Building Faber

Stefan Seefeld edited this page Dec 2, 2018 · 3 revisions

Building

Building Faber is as simple as running <python> setup.py build (replace with the name of the python executable you want to use, such as python3 or /your/path/to/python/executable).

This will place the built modules and scripts into build/lib.<platform>-<python-version> and build/scripts-<python-version> respectively.


Note

Starting with Python 3.6 Faber uses a new scheduler entirely written in Python. Thus Faber is a native Python application without any C code to compile. It's thus possible to use faber directly from the source tree without first compiling it. Simply adjust the PYTHONPATH to include the source tree, and make sure to invoke scripts/faber explicitly with the appropriate Python executable, i.e. python3.6 scripts/faber


Testing

The Faber test suite can be performed using py.test tests. Make sure to set PYTHONPATH appropriately so the Faber modules are properly found.

Installing

Install Faber using <python> setup.py install (use --help to see possible options to fine-tune the process, including setting the install prefix). If you choose a non-default installation prefix, make sure to have your PYTHONPATH adjusted appropriately for faber to find its modules.