Miguel Barão / perguntations

README.md 1.34 KB

README

Requirements:

The webserver is a python3 application and only requires python to be installed. Versions 3.3, 3.4 and 3.5 should be Ok. It does not require any other webserver (apache, ...)

Installed using pip:

  • 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 or /home/username. Run the following commands:


cd WHERE/TO/PUT/THE/SOFTWARE

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

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

# update test configuration with the correct database file.
vi demo/test.yaml
# Edit line 7 to something like
# database: db/students.db

# get help
./serve.py --help 

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

# open browser at http://127.0.0.1:8080/
# the professor is number 0

# ^C to terminate the server

(FIXME 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