# README #


### Requirements:

Installed using `pip3`:

- CherryPy (3.7.0)
- Mako (1.0.1)
- Markdown (2.6.2)
- PyYAML (3.11)
- bcrypt (2.0.0)

### System setup:

Open a terminal and navigate to a directory where this software is to be installed, e.g. `/var/www`. Then run the following commands:

```
#!bash

# get the software using git
git clone https://mjsb@bitbucket.org/mjsb/perguntations.git
cd perguntations

# create database in the directory db/
initdb_from_csv.py siiue.csv
mkdir db
mv students.db db

# update test configuration
vi demo/test.yaml                # update students_db

# run demo test
./serve demo/test.yaml
```

(For the time being, also create `ans`, `questions`, `tests`, `scripts`, `sessions` in the same directory, until paths are fixed)

### Contribute ###

* Writing questions in yaml format
* Testing and reporting bugs
* Code review
* New features and ideas

### Contacts ###

* Miguel Barão mjsb@di.uevora.pt