/tester

:question: An opinionated tool for creating randomly generated PDF tests.

Primary LanguagePythonMIT LicenseMIT

Tester

Requirements

  • Python 3.7+

Setup

First install wkhtmltopdf on your system such that it is accessible from your terminal. On Mac, this is:

brew cask install wkhtmltopdf

Then navigate to this repo and run:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

For development:

python3 setup.py develop

For use:

python3 setup.py install

Running

With your installation complete, run:

tester

Directory Structure

All of the tester content is stored within a _tester_data/ directory.

  • _tester_data/ - Stores all tester data
    • <course directories> - Organizes data by course, enabling multiple courses at once
      • _questions/ - Stores the question pool for the course
        • <question directories>
      • _tests/ - Stores test builds
        • <test directories>
      • modules.json - Stores module information
      • students.json - Stores student information
      • solution_instructions.md - The text to be placed at the top of a generated solution.
      • custom.css - Custom CSS for generated tests and solutions.
    • context.json - Stores tester context information such as the currently active course

The path to the _tester_data/ directory is set to by the TESTER_DATA_DIR_PATH environment variable.