98 lines
4.4 KiB
Python
98 lines
4.4 KiB
Python
"""
|
|
This file contains tasks that are designed to perform background operations on the
|
|
running state of a course.
|
|
|
|
At present, these tasks all operate on StudentModule objects in one way or another,
|
|
so they share a visitor architecture. Each task defines an "update function" that
|
|
takes a module_descriptor, a particular StudentModule object, and xmodule_instance_args.
|
|
|
|
A task may optionally specify a "filter function" that takes a query for StudentModule
|
|
objects, and adds additional filter clauses.
|
|
|
|
A task also passes through "xmodule_instance_args", that are used to provide
|
|
information to our code that instantiates xmodule instances.
|
|
|
|
The task definition then calls the traversal function, passing in the three arguments
|
|
above, along with the id value for an InstructorTask object. The InstructorTask
|
|
object contains a 'task_input' row which is a JSON-encoded dict containing
|
|
a problem URL and optionally a student. These are used to set up the initial value
|
|
of the query for traversing StudentModule objects.
|
|
|
|
"""
|
|
from celery import task
|
|
from instructor_task.tasks_helper import (update_problem_module_state,
|
|
rescore_problem_module_state,
|
|
reset_attempts_module_state,
|
|
delete_problem_module_state)
|
|
|
|
|
|
@task
|
|
def rescore_problem(entry_id, xmodule_instance_args):
|
|
"""Rescores a problem in a course, for all students or one specific student.
|
|
|
|
`entry_id` is the id value of the InstructorTask entry that corresponds to this task.
|
|
The entry contains the `course_id` that identifies the course, as well as the
|
|
`task_input`, which contains task-specific input.
|
|
|
|
The task_input should be a dict with the following entries:
|
|
|
|
'problem_url': the full URL to the problem to be rescored. (required)
|
|
|
|
'student': the identifier (username or email) of a particular user whose
|
|
problem submission should be rescored. If not specified, all problem
|
|
submissions for the problem will be rescored.
|
|
|
|
`xmodule_instance_args` provides information needed by _get_module_instance_for_task()
|
|
to instantiate an xmodule instance.
|
|
"""
|
|
action_name = 'rescored'
|
|
update_fcn = rescore_problem_module_state
|
|
filter_fcn = lambda(modules_to_update): modules_to_update.filter(state__contains='"done": true')
|
|
return update_problem_module_state(entry_id,
|
|
update_fcn, action_name, filter_fcn=filter_fcn,
|
|
xmodule_instance_args=xmodule_instance_args)
|
|
|
|
|
|
@task
|
|
def reset_problem_attempts(entry_id, xmodule_instance_args):
|
|
"""Resets problem attempts to zero for a particular problem for all students in a course.
|
|
|
|
`entry_id` is the id value of the InstructorTask entry that corresponds to this task.
|
|
The entry contains the `course_id` that identifies the course, as well as the
|
|
`task_input`, which contains task-specific input.
|
|
|
|
The task_input should be a dict with the following entries:
|
|
|
|
'problem_url': the full URL to the problem to be rescored. (required)
|
|
|
|
`xmodule_instance_args` provides information needed by _get_module_instance_for_task()
|
|
to instantiate an xmodule instance.
|
|
"""
|
|
action_name = 'reset'
|
|
update_fcn = reset_attempts_module_state
|
|
return update_problem_module_state(entry_id,
|
|
update_fcn, action_name, filter_fcn=None,
|
|
xmodule_instance_args=xmodule_instance_args)
|
|
|
|
|
|
@task
|
|
def delete_problem_state(entry_id, xmodule_instance_args):
|
|
"""Deletes problem state entirely for all students on a particular problem in a course.
|
|
|
|
`entry_id` is the id value of the InstructorTask entry that corresponds to this task.
|
|
The entry contains the `course_id` that identifies the course, as well as the
|
|
`task_input`, which contains task-specific input.
|
|
|
|
The task_input should be a dict with the following entries:
|
|
|
|
'problem_url': the full URL to the problem to be rescored. (required)
|
|
|
|
`xmodule_instance_args` provides information needed by _get_module_instance_for_task()
|
|
to instantiate an xmodule instance.
|
|
"""
|
|
action_name = 'deleted'
|
|
update_fcn = delete_problem_module_state
|
|
return update_problem_module_state(entry_id,
|
|
update_fcn, action_name, filter_fcn=None,
|
|
xmodule_instance_args=xmodule_instance_args)
|