How to run SQLittaaja

SQLittaaja's command-line interface

SQLittaaja requires two files to run:

• a configuration file in .toml format and
• a zip file containing exercise submissions.

By default, SQLittaaja looks for the 'config.toml' file in the directory from which it is run. You can specify the configuration file with a command-line argument. You can also open the generated HTML report using the -o or --open-report flag. Note that the configuration file is a positional argument and can be given without any -c or --config options.

sqlittaaja your_config.toml -o

Student submissions ZIP file and its structure

Path to the zip file is defined in the configuration file at:

[[exercises]]
# This is the path to a ZIP-file for the student submissions.
path = "path/to/submissions.zip"
# Other options
# ...

The zip file must have a directory for each student. The directory must be named accordingly: with the first student's name (which can include spaces), followed by an underscore character '_', which serves as a cutting-off point. Each directory contains the student's exercise submission file.

# For example:
exercises.zip\John Doe_5694529_assignsubmission_file\exercise2.txt