Installation

The Frootlab Shared Library (flib) requires Python 3.7 or later. If you do not already have a Python environment configured on your computer, please see the instructions for installing the full scientific Python stack.

Note

If you are using the Windows platform and want to install optional packages (e.g., scipy), then it may be useful to install a Python distribution such as: Anaconda, Enthought Canopy, Python(x,y), WinPython, or Pyzo. If you already use one of these Python distributions, please refer to their online documentation.

Below it is assumed, that you have the default Python environment configured on your computer and you intend to install the frootlab shared library inside of it. If you want to create and work with Python virtual environments, please follow instructions on venv and virtual environments.

Install the latest distributed package

You can install the latest distributed package of flib by using pip:

$ pip install flib

Install the development branch

The installation requires that you have Git installed on your system. Under this prerequisite the first step is to clone the github repository of flib:

$ git clone https://github.com/frootlab/flib.git

Thereupon the development branch can locally be installed by using pip:

$ cd flib
$ pip install -e .

The pip install command allows you to follow the development branch as it changes by creating links in the right places and installing the command line scripts to the appropriate locations.

Update the development branch

Once you have cloned the GitHub repository onto a local directory, you can update it anytime by running a git pull in this directory:

$ git pull

Testing the development branch

The Frootlab Shared Library uses the Python builtin module :module:`unittest` for testing. Since the tests are not included in the distributed package at you are required to install the development branch, as described above. Thereupon you have to switch to the repository directory and run:

$ python3 tests