inginious.frontend.plugins package

Plugins for the webapp of INGInious


inginious.frontend.plugins.demo module

A demo plugin that adds a page

class inginious.frontend.plugins.demo.DemoPage[source]

Bases: inginious.frontend.pages.utils.INGIniousPage

A simple demo page showing how to add a new page


GET request

methods: Optional[List[str]] = {'GET', 'POST'}

A list of methods this view can handle.

inginious.frontend.plugins.demo.init(plugin_manager, _, _2, _3)[source]

Init the plugin

inginious.frontend.plugins.contests module

An algorithm contest plugin for INGInious. Based on the same principles than contests like ACM-ICPC.

class inginious.frontend.plugins.contests.ContestAdmin[source]

Bases: inginious.frontend.pages.course_admin.utils.INGIniousAdminPage

Contest settings for a course


GET request: simply display the form


POST request: update the settings

methods: Optional[List[str]] = {'GET', 'POST'}

A list of methods this view can handle.

save_contest_data(course, contest_data)[source]

Saves updated contest data for the course

class inginious.frontend.plugins.contests.ContestScoreboard[source]

Bases: inginious.frontend.pages.utils.INGIniousAuthPage

Displays the scoreboard of the contest

methods: Optional[List[str]] = {'GET', 'POST'}

A list of methods this view can handle.


Add a menu for the contest settings in the administration


Additional HTML headers

inginious.frontend.plugins.contests.course_menu(course, template_helper)[source]

Displays some informations about the contest on the course page


Returns the settings of the contest for this course

inginious.frontend.plugins.contests.init(plugin_manager, course_factory, client, config)[source]

Init the contest plugin. Available configuration:

    "plugin_module": "inginious.frontend.plugins.contests"
inginious.frontend.plugins.contests.task_accessibility(course, task, default)[source]

inginious.frontend.plugins.git_repo module

A plugin that allows to save submissions to a Git repository

class inginious.frontend.plugins.git_repo.SubmissionGitSaver(plugin_manager, config)[source]

Bases: threading.Thread

Thread class that saves results from submission in the git repo. It must be a thread as a git commit can take some time and because we extract archives returned by the Client. But it must also be launched only one time as our git operations are not really process/tread-safe ;-)

add(submission, archive, _)[source]

Add a new submission to the repo (add the to queue, will be saved async)


Method representing the thread’s activity.

You may override this method in a subclass. The standard run() method invokes the callable object passed to the object’s constructor as the target argument, if any, with sequential and keyword arguments taken from the args and kwargs arguments, respectively.

save(submission, result, grade, problems, tests, custom, archive)[source]

saves a new submission in the repo (done async)

inginious.frontend.plugins.git_repo.init(plugin_manager, _, _2, config)[source]

Init the plugin

Available configuration:

    - plugin_module: inginious.frontend.plugins.git_repo
      repo_directory: "./repo_submissions"

inginious.frontend.plugins.simple_grader module

Allow the webapp to act as a simple POST grader

inginious.frontend.plugins.simple_grader.init(plugin_manager, course_factory, client, config)[source]

Init the external grader plugin. This simple grader allows only anonymous requests, and submissions are not stored in database.

Available configuration:

    - plugin_module: inginious.frontend.plugins.simple_grader
      courseid : "external"
      page_pattern: "/external"
      return_fields: "^(result|text|problems)$"

The grader will only return fields that are in the job return dict if their key match return_fields.

Different types of request are available : see documentation