Metadata-Version: 2.1
Name: INGInious
Version: 0.8.2
Summary: An intelligent grader that allows secured and automated testing of code made by students.
Home-page: https://github.com/UCL-INGI/INGInious
Author: INGInious contributors
Author-email: inginious@info.ucl.ac.be
License: AGPL 3
Provides-Extra: cgi
Provides-Extra: ldap
Provides-Extra: saml2
Provides-Extra: uwsgi
Provides-Extra: test
Provides-Extra: doc
License-File: LICENSE

INGInious
=========

.. image:: https://api.codacy.com/project/badge/Grade/7cd8340004ef4d409143d5c24259efc1
   :alt: Codacy Badge
   :target: https://app.codacy.com/gh/UCL-INGI/INGInious?utm_source=github.com&utm_medium=referral&utm_content=UCL-INGI/INGInious&utm_campaign=Badge_Grade_Dashboard
.. image:: https://app.codacy.com/project/badge/Coverage/9102bbf54901478dbe288a386195f77e
   :alt: Codacy coverage Badge
   :target: https://www.codacy.com/gh/UCL-INGI/INGInious/dashboard?utm_source=github.com&utm_medium=referral&utm_content=UCL-INGI/INGInious&utm_campaign=Badge_Coverage
.. image:: https://github.com/UCL-INGI/INGInious/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/UCL-INGI/INGInious/actions
.. image:: https://readthedocs.org/projects/inginious/badge/?version=latest
    :target: https://readthedocs.org/projects/inginious/?badge=latest
.. image:: http://weblate.info.ucl.ac.be/widgets/inginious/-/frontend/svg-badge.svg
    :target: http://weblate.info.ucl.ac.be/engage/inginious/?utm_source=widget

INGInious is an intelligent grader that allows secured and automated testing of code made by students.

It is written in Python and uses Docker_ to run student's code inside a secured environment.

INGInious provides a backend which manages interaction with Docker and grade code, and a frontend which allows students to submit their code in a simple and beautiful interface. The frontend also includes a simple administration interface that allows teachers to check the progression of their students and to modify exercices in a simple way.

The backend is independent of the frontend and was made to be used as a library.

INGInious can be used as an external grader for EDX. The course `Paradigms of Computer Programming - Fundamentals`_ uses INGInious to correct students' code.

.. _Docker: https://www.docker.com/
.. _Paradigms of Computer Programming - Fundamentals: https://www.edx.org/course/louvainx/louvainx-louv1-1x-paradigms-computer-2751

Documentation
-------------

The documentation is available on Read the Docs:

- For the stable branch : http://inginious.readthedocs.org/
- For the master (dev) branch (not always up to date) : http://inginious.readthedocs.org/en/latest/index.html

On Linux, run ``make html`` in the directory ``/doc`` to create a html version of the documentation.


Notes on security
-----------------

Docker containers can be used securely with SELinux enabled. Please do not run untrusted code without activating SELinux.

Mailing list
------------

A mailing list for both usage and development discussion can be joined by registering here_.

..  _here: https://sympa-2.sipr.ucl.ac.be/sympa/info/inginious
