summaryrefslogtreecommitdiff
path: root/INSTALL.md
blob: 5a48911721a9b2118ee5620b8cd13f42792903fc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# Installation

Typical installation as a library

    pip3 install qface
    
# Install for Development
Installing as python executable using pip3 (python3)

    git clone git@github.com:Pelagicore/qface.git
    cd qface
    pip3 install -e .

Installs qface as an "editable" package. Means updates on the local git repo are reflected. If this is not what you want you can install it with

    cd qface
    pip3 install .


# Setup Develoment

To install the python dependencies use

    cd qface
    pip3 install -r requirements.txt
    pip3 install -e .

For updating the grammar you also need antlr4 (see http://www.antlr.org).

# Tests

The commands are controlled by the cli.py script.

    cd qface
    ./cli.py --help

To run the tests once

    ./cli.py test

To monitor the tests and auto-run the tests

    cd qface
    ./cli.py test_monitor