inginious.frontend.pages package

Frontend pages (controllers)

Subpackages

• inginious.frontend.pages.api package
  • Submodules
  • inginious.frontend.pages.api.auth_methods module
  • inginious.frontend.pages.api.authentication module
  • inginious.frontend.pages.api.courses module
  • inginious.frontend.pages.api.submissions module
  • inginious.frontend.pages.api.tasks module
• inginious.frontend.pages.course_admin package
  • Submodules
  • inginious.frontend.pages.course_admin.audience_edit module
  • inginious.frontend.pages.course_admin.danger_zone module
  • inginious.frontend.pages.course_admin.settings module
  • inginious.frontend.pages.course_admin.student_list module
  • inginious.frontend.pages.course_admin.submission module
  • inginious.frontend.pages.course_admin.task_edit module
  • inginious.frontend.pages.course_admin.task_edit_file module
  • inginious.frontend.pages.course_admin.task_list module
  • inginious.frontend.pages.course_admin.utils module

Submodules

inginious.frontend.pages.group module

Index page

class inginious.frontend.pages.group.GroupPage

Bases: inginious.frontend.pages.utils.INGIniousAuthPage

Group page

GET_AUTH(courseid)

GET request

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

A list of methods this view can handle.

inginious.frontend.pages.course module

Course page

class inginious.frontend.pages.course.CoursePage

Bases: inginious.frontend.pages.utils.INGIniousAuthPage

Course page

GET_AUTH(courseid)

GET request

POST_AUTH(courseid)

POST request

get_course(courseid)

Return the course

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

A list of methods this view can handle.

preview_allowed(courseid)

If this function returns True, the auth check is disabled. Override this function with a custom check if needed.

show_page(course)

Prepares and shows the course page

inginious.frontend.pages.course.handle_course_unavailable(app_homepath, template_helper, user_manager, course)

Displays the course_unavailable page or the course registration page

inginious.frontend.pages.index module

Index page

class inginious.frontend.pages.index.IndexPage

Bases: inginious.frontend.pages.utils.INGIniousStaticPage

Index page

GET()

Display main course list page

POST()

Display main course list page

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

A list of methods this view can handle.

inginious.frontend.pages.maintenance module

Maintenance page

class inginious.frontend.pages.maintenance.MaintenancePage

Bases: flask.views.MethodView

Maintenance page

get(path)

GET request

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

A list of methods this view can handle.

post(path)

POST request

inginious.frontend.pages.tasks module

Task page

class inginious.frontend.pages.tasks.BaseTaskPage(calling_page)

Bases: object

Display a task (and allow to reload old submission/file uploaded during a submission)

GET(courseid, taskid, is_LTI)

GET request

POST(courseid, taskid, isLTI)

POST a new submission

preview_allowed(courseid, taskid)

submission_to_json(task, data, debug, reloading=False, replace=False, tags=None)

Converts a submission to json (keeps only needed fields)

class inginious.frontend.pages.tasks.TaskPage

Bases: inginious.frontend.pages.utils.INGIniousAuthPage

GET_AUTH(courseid, taskid)

POST_AUTH(courseid, taskid)

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

A list of methods this view can handle.

preview_allowed(courseid, taskid)

If this function returns True, the auth check is disabled. Override this function with a custom check if needed.

class inginious.frontend.pages.tasks.TaskPageStaticDownload

Bases: inginious.frontend.pages.utils.INGIniousPage

Allow to download files stored in the task folder

GET(courseid, taskid, path)

GET request

is_lti_page()

True if the current page allows LTI sessions. False else.

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

A list of methods this view can handle.

inginious.frontend.pages.utils module

Some utils for all the pages

class inginious.frontend.pages.utils.INGIniousAuthPage

Bases: inginious.frontend.pages.utils.INGIniousPage

Augmented version of INGIniousPage that checks if user is authenticated.

GET(*args, **kwargs)

Checks if user is authenticated and calls GET_AUTH or performs logout. Otherwise, returns the login template.

GET_AUTH(*args, **kwargs)

POST(*args, **kwargs)

Checks if user is authenticated and calls POST_AUTH or performs login and calls GET_AUTH. Otherwise, returns the login template.

POST_AUTH(*args, **kwargs)

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

A list of methods this view can handle.

preview_allowed(*args, **kwargs)

If this function returns True, the auth check is disabled. Override this function with a custom check if needed.

class inginious.frontend.pages.utils.INGIniousPage

Bases: flask.views.MethodView

A base for all the pages of the INGInious webapp. Contains references to the PluginManager, the CourseFactory, and the SubmissionManager

property app

Returns the web application singleton

property backup_dir

Backup directory

property client

Returns the INGInious client

property course_factory

Returns the course factory singleton

property database

Returns the database singleton

property default_allowed_file_extensions

List of allowed file extensions

property default_max_file_size

Default maximum file size for upload

property environment_types

Available environment types

property environments

Available environments

get(sessionid, *args, **kwargs)

property gridfs

Returns the GridFS singleton

property is_lti_page

True if the current page allows LTI sessions. False else.

property logger

Logger

property lti_outcome_manager

Returns the LTIOutcomeManager singleton

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

A list of methods this view can handle.

property plugin_manager

Returns the plugin manager singleton

post(sessionid, *args, **kwargs)

property submission_manager

Returns the submission manager singleton

property task_factory

Returns the task factory singleton

property template_helper

Returns the Template Helper singleton

property user_manager

Returns the user manager singleton

property webdav_host

True if webdav is available

property webterm_link

Returns the link to the web terminal

class inginious.frontend.pages.utils.INGIniousStaticPage

Bases: inginious.frontend.pages.utils.INGIniousPage

GET(pageid)

POST(pageid)

cache = {}

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

A list of methods this view can handle.

show_page(page)

class inginious.frontend.pages.utils.LogOutPage

Bases: inginious.frontend.pages.utils.INGIniousAuthPage

GET_AUTH(*args, **kwargs)

POST_AUTH(*args, **kwargs)

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

A list of methods this view can handle.

class inginious.frontend.pages.utils.SignInPage

Bases: inginious.frontend.pages.utils.INGIniousAuthPage

GET()

Checks if user is authenticated and calls GET_AUTH or performs logout. Otherwise, returns the login template.

GET_AUTH(*args, **kwargs)

POST_AUTH(*args, **kwargs)

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

A list of methods this view can handle.

inginious.frontend.pages.utils.generate_user_selection_box(user_manager: inginious.frontend.user_manager.UserManager, render_func, current_users: List[str], course_id: str, name: str, id: str, placeholder: Optional[str] = None, single=False)

Returns the HTML for a user selection box. The user using the box must have admin/tutors rights on the course with id course_id.

The box will return, when submitted using a form, a list of usernames separated by commas, under the given name.

NB: this function is available in the templates directly as “$user_selection_box(current_users, course_id, name, id)”. You must ignore the first argument (template_helper) in the templates.

Parameters

• user_manager – UserManager instance

• render_func – template generator

• current_users – a list of usernames currently selected

• course_id – the course id

• name – HTML name given to the box

• id – HTML id given to the box

• single – False for multiple user selection, True for single user selection

Returns

HTML code for the box

inginious.frontend.pages.utils.register_utils(database, user_manager, template_helper: inginious.frontend.template_helper.TemplateHelper)

Registers utils in the template helper