Skip to content
/ EvaP Public
forked from e-valuation/EvaP

a university course evaluation system written in Python using Django

License

Notifications You must be signed in to change notification settings

Kakadus/EvaP

 
 

Repository files navigation

EvaP - Evaluation Platform

Build Status Codacy Badge codecov

What is EvaP?

EvaP is the course evaluation system used internally at Hasso Plattner Institute at the University of Potsdam.

For the documentation, please see our wiki.

Installation

The easiest setup using Vagrant is shown here.

  1. Install git, Vagrant, and one of VirtualBox (recommended) or Docker (for ARM systems).

  2. Fork the EvaP repository (using the Fork-button in the upper right corner on GitHub).

  3. Windows users only (might not apply for the Linux subsystem):

    • Line endings: git's core.autocrlf setting has to be false or input 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
  4. 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 with vagrant 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
  5. Open your browser at http://localhost:8000/ and login with email [email protected] and password evap.

That's it!

Contributing

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.

License

MIT, see LICENSE.md.

Supported Browsers

The platform is only tested in Mozilla Firefox and Google Chrome. Other browsers might not render all pages correctly.

About

a university course evaluation system written in Python using Django

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 68.5%
  • HTML 23.9%
  • TypeScript 3.8%
  • SCSS 2.4%
  • Other 1.4%