SPEF (student project evaluation framework)

Požiadavky na spustenie

• python 3.10+
• pyyaml 6.0+
• pygments 2.12.0+
• jinja2 3.1.2+
• docker

Spustenie frameworku

Pred spustením je projekt nutné nainštalovať (napr. vo virtualenv)

• pip install .
• alebo pip install -e . pre tzv. "editable" inštaláciu

Instalace dodatečných závislostí vhodných pro vývoj:

• pip install -e .[dev]

Spustenie je následne možné pomocou jedného z príkazov:

• spef
• python -m spef

Spustenie testov

• prepare_tests.sh (ak nie je vytvorený Docker image 'test')
• run_tests.sh

Adresárová štruktúra zdrojových kódov

• example/ obsahuje ukážkový adresár projektu
• spef/ obsahuje zdrojové kódy systému
• tests/ obsahuje integračné testy systému
• prepare_tests.sh vytvorí Docker image 'test' potrebný pre spustenie integračných testov
• run_tests.sh spustí integračné testy

Ukážkový adresár projektu

V adresári example je založený ukážkový projekt pre vyskúšanie frameworku. Adresár obsahuje:

• študentské riešenia (archívy, ktoré treba rozbaliť),
• testy v pod-adresári tests,
• testovaciu stratégiu v súbore tests/testsuite.sh,
• Dockerfile pre vytvorenie docker imagu na testovanie,
• upravený konfiguračný súbor projektu. Autor testov a súboru tradelog: Aleš Smrčka