EvaP is the course evaluation system used internally at Hasso Plattner Institute at the University of Potsdam.
For the documentation, please see our wiki.
The easiest setup using Vagrant is shown here.
-
Install git, Vagrant, and one of VirtualBox (recommended) or Docker (for ARM systems).
-
Fork the EvaP repository (using the Fork-button in the upper right corner on GitHub).
-
Windows users only (might not apply for the Linux subsystem):
-
Line endings: git's
core.autocrlf
setting has to befalse
orinput
so git does not convert line endings on checkout, because the code will be used in a Linux VM. We suggest using this command in Git Bash:git config --global core.autocrlf input
-
-
Run the following commands on the command line to clone the repository, create the Vagrant VM and run the Django development server. To use Docker, replace
vagrant up
withvagrant up --provider docker && vagrant provision
.git clone --recurse-submodules https://github.com/<your_github_username>/EvaP.git cd EvaP vagrant up vagrant ssh ./manage.py run
-
Open your browser at https://localhost:8000/ and login with email
[email protected]
and passwordevap
.
That's it!
We'd love to see contributions, feel free to fork! You should probably branch off main
, the branch release
is used for stable revisions.
Before committing, run the following commands:
./manage.py test
(runs the test suite)./manage.py lint
(runs linting)./manage.py format
(applies automatic code formatting)
or, to combine all three, simply run ./manage.py precommit
.
You can also set up pylint
, isort
, black
and prettier
in your IDE to avoid doing this manually all the time.
MIT, see LICENSE.md.
The platform is only tested in Mozilla Firefox and Google Chrome. Other browsers might not render all pages correctly.