Installation of the Development Environment

It is highly recommended to set up a virtual environment for JetConf development. The following procedure uses the venv module for this purpose (it is included in the standard Python library since version 3.3).

1. Install the latest stable Python 3 version.

2. Clone the JetConf project in a directory of your choice:

   $ git clone git@gitlab.labs.nic.cz:labs/jetconf.git

3. Create the virtual environment:

   $ python3 -m venv jetconf

4. Activate the virtual environment:

   $ cd jetconf
   $ source bin/activate

5. Install required standard packages inside the virtual environment:

   $ make install-deps

   If you are prompted to upgrade pip, you can do that, too.

When inside the virtual environment, the shell prompt should change to something like

(jetconf) $

To leave the virtual environment, just do

$ deactivate

The virtual environment can be entered anytime later by executing step 4. The steps preceding it need to be performed just once.

The setup described above has a few consequences that have to be kept in mind:

• Any project files that need to go to bin (executable Python scripts), include or lib have to be added as exceptions to .gitignore, for example

!bin/jetconf

• After adding a new Python module dependency, it is necessary to run

  $ make deps

  and commit the new content of requirements.txt.