Metadata-Version: 2.1
Name: INGInious
Version: 0.5
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
Platform: UNKNOWN
Requires-Dist: docker (>=2.5.0)
Requires-Dist: docutils (>=0.14)
Requires-Dist: pymongo (>=3.2.2)
Requires-Dist: PyYAML (>=3.11)
Requires-Dist: web.py (>=0.40.dev0)
Requires-Dist: lti (>=0.9.0)
Requires-Dist: oauth2 (>=1.9.0.post1)
Requires-Dist: httplib2 (>=0.9)
Requires-Dist: watchdog (>=0.8.3)
Requires-Dist: msgpack-python (>=0.4.7)
Requires-Dist: pyzmq (>=15.3.0)
Requires-Dist: natsort (>=5.0.1)
Requires-Dist: psutil (>=4.4.2)
Requires-Dist: zipstream (>=1.1.4)
Requires-Dist: pytidylib (>=0.2.4)
Requires-Dist: sphinx-rtd-theme (>=0.1.8)
Requires-Dist: sh (>=1.11)
Provides-Extra: cgi
Requires-Dist: flup (>=1.0.3.dev) ; extra == 'cgi'
Provides-Extra: ldap
Requires-Dist: ldap3 ; extra == 'ldap'
Provides-Extra: saml2
Requires-Dist: python3-saml ; extra == 'saml2'
Provides-Extra: test
Requires-Dist: selenium ; extra == 'test'
Requires-Dist: nose ; extra == 'test'
Requires-Dist: pyvirtualdisplay ; extra == 'test'
Provides-Extra: uwsgi
Requires-Dist: uwsgi ; extra == 'uwsgi'

INGInious
=========

.. image:: http://jenkins2.info.ucl.ac.be/job/INGInious/badge/icon
    :target: http://jenkins2.info.ucl.ac.be/job/INGInious/
.. image:: https://landscape.io/github/UCL-INGI/INGInious/master/landscape.svg?style=flat
    :target: https://landscape.io/github/UCL-INGI/INGInious/master
.. image:: https://readthedocs.org/projects/inginious/badge/?version=latest
    :target: https://readthedocs.org/projects/inginious/?badge=latest
.. image:: https://badges.gitter.im/Join%20Chat.svg
    :target: https://gitter.im/UCL-INGI/INGInious?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge


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


