15
15
# along with this program; if not, write to the Free Software
16
16
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
# Module: TutorialService
22
# Provides the AJAX backend for the tutorial application.
23
# This allows several actions to be performed on the code the student has
24
# typed into one of the exercise boxes.
28
# The arguments determine what is to be done on this file.
30
# "exercise" - The path to a exercise file (including the .xml extension),
31
# relative to the subjects base directory.
32
# "code" - Full text of the student's code being submitted.
33
# "action". May be "test". (More to come).
35
# Returns a JSON response string indicating the results.
18
# Author: Matt Giuca, Nick Chadwick
20
'''AJAX backend for the tutorial application.'''
42
from common import (db, util)
47
"""Handler for Ajax backend TutorialService app."""
48
# Set request attributes
49
req.write_html_head_foot = False # No HTML
52
req.throw_error(req.HTTP_BAD_REQUEST)
53
# Get all the arguments, if POST.
54
# Ignore arguments if not POST, since we aren't allowed to cause
55
# side-effects on the server.
56
fields = req.get_fieldstorage()
57
act = fields.getfirst('action')
58
exercise = fields.getfirst('exercise')
59
code = fields.getfirst('code')
61
if exercise == None or code == None or act == None:
62
req.throw_error(req.HTTP_BAD_REQUEST)
64
exercise = exercise.value
68
handle_save(req, exercise, code, fields)
70
handle_test(req, exercise, code, fields)
72
handle_run(req, exercise, code, fields)
74
req.throw_error(req.HTTP_BAD_REQUEST)
76
def handle_save(req, exercise, code, fields):
77
"""Handles a save action. This saves the user's code without executing it.
79
# Need to open JUST so we know this is a real exercise.
80
# (This avoids users submitting code for bogus exercises).
81
exercisefile = util.open_exercise_file(exercise)
82
if exercisefile is None:
83
req.throw_error(req.HTTP_NOT_FOUND,
84
"The exercise was not found.")
87
req.write('{"result": "ok"}')
92
conn.write_problem_save(
93
login = req.user.login,
94
exercisename = exercise,
95
date = time.localtime(),
100
def handle_test(req, exercise, code, fields):
101
"""Handles a test action."""
103
exercisefile = util.open_exercise_file(exercise)
104
if exercisefile is None:
105
req.throw_error(req.HTTP_NOT_FOUND,
106
"The exercise was not found.")
108
# Parse the file into a exercise object using the test suite
109
exercise_obj = test.parse_exercise_file(exercisefile)
111
# Run the test cases. Get the result back as a JSONable object.
113
test_results = exercise_obj.run_tests(code)
117
conn.insert_problem_attempt(
118
login = req.user.login,
119
exercisename = exercise,
120
date = time.localtime(),
121
complete = test_results['passed'],
28
from ivle.database import Exercise, ExerciseAttempt, ExerciseSave, Worksheet, Offering, Subject, Semester
31
import ivle.webapp.tutorial.test
33
from ivle.webapp.base.rest import (JSONRESTView, named_operation,
35
from ivle.webapp.errors import NotFound
37
# If True, getattempts or getattempt will allow browsing of inactive/disabled
38
# attempts. If False, will not allow this.
39
HISTORY_ALLOW_INACTIVE = False
41
TIMESTAMP_FORMAT = '%Y-%m-%d %H:%M:%S'
44
class AttemptsRESTView(JSONRESTView):
45
'''REST view of a user's attempts at an exercise.'''
46
def __init__(self, req, subject, year, semester, worksheet,
48
self.user = ivle.database.User.get_by_login(req.store, username)
51
self.exercise = exercise
53
self.worksheet = req.store.find(Worksheet,
54
Worksheet.name == worksheet,
55
Worksheet.offering_id == Offering.id,
56
Offering.subject_id == Subject.id,
57
Subject.code == subject,
58
Offering.semester_id == Semester.id,
59
Semester.year == year,
60
Semester.semester == semester).one()
62
self.context = self.user # XXX: Not quite right.
64
@require_permission('edit')
66
"""Handles a GET Attempts action."""
67
exercise = req.store.find(Exercise, Exercise.id == self.exercise).one()
69
attempts = req.store.find(ExerciseAttempt,
70
ExerciseAttempt.exercise_id == exercise.id,
71
ExerciseAttempt.user_id == self.user.id)
72
# attempts is a list of ExerciseAttempt objects. Convert to dictionaries
73
time_fmt = lambda dt: datetime.datetime.strftime(dt, TIMESTAMP_FORMAT)
74
attempts = [{'date': time_fmt(a.date), 'complete': a.complete}
80
@require_permission('edit')
81
def PUT(self, req, data):
82
""" Tests the given submission """
83
exercise = req.store.find(Exercise, Exercise.id == self.exercise).one()
87
# Start a console to run the tests on
88
jail_path = os.path.join(ivle.conf.jail_base, req.user.login)
89
working_dir = os.path.join("/home", req.user.login)
90
cons = ivle.console.Console(req.user.unixid, jail_path, working_dir)
92
# Parse the file into a exercise object using the test suite
93
exercise_obj = ivle.webapp.tutorial.test.parse_exercise_file(
96
# Run the test cases. Get the result back as a JSONable object.
98
test_results = exercise_obj.run_tests(data['code'])
103
attempt = ivle.database.ExerciseAttempt(user=req.user,
105
date=datetime.datetime.now(),
106
complete=test_results['passed'],
107
worksheet=self.worksheet,
108
text=unicode(data['code']))
110
req.store.add(attempt)
124
112
# Query the DB to get an updated score on whether or not this problem
125
113
# has EVER been completed (may be different from "passed", if it has
126
114
# been completed before), and the total number of attempts.
127
completed, attempts = conn.get_problem_status(req.user.login,
115
completed, attempts = ivle.worksheet.get_exercise_status(req.store,
116
req.user, exercise, self.worksheet)
129
117
test_results["completed"] = completed
130
118
test_results["attempts"] = attempts
132
req.write(cjson.encode(test_results))
136
def handle_run(req, exercise, code, fields):
137
"""Handles a run action."""
138
# Extremely makeshift.
139
# For now, just echo the code back
141
out_json = {"stdout": output}
142
req.write(cjson.encode(out_json))
123
class AttemptRESTView(JSONRESTView):
124
'''REST view of an exercise attempt.'''
126
def __init__(self, req, subject, worksheet, exercise, username, date):
127
# TODO: Find exercise within worksheet.
128
user = ivle.database.User.get_by_login(req.store, username)
133
date = datetime.datetime.strptime(date, TIMESTAMP_FORMAT)
137
exercise = ivle.database.Exercise.get_by_name(req.store, exercise)
138
worksheet = req.store.find(Worksheet,
139
Worksheet.name == self.worksheet,
140
Worksheet.offering_id == Offering.id,
141
Offering.subject_id == Subject.id,
142
Subject.code == self.subject,
143
Offering.semester_id == Semester.id,
144
Semester.year == self.year,
145
Semester.semester == self.semester).one()
147
attempt = ivle.worksheet.get_exercise_attempt(req.store, user,
148
exercise, worksheet, as_of=date, allow_inactive=HISTORY_ALLOW_INACTIVE)
153
self.context = attempt
155
@require_permission('view')
157
return {'code': self.context.text}
160
class ExerciseRESTView(JSONRESTView):
161
'''REST view of an exercise.'''
163
def get_permissions(self, user):
164
# XXX: Do it properly.
170
@named_operation('save')
171
def save(self, req, text):
172
# Need to open JUST so we know this is a real exercise.
173
# (This avoids users submitting code for bogus exercises).
174
exercise = req.store.find(Exercise,
175
Exercise.id == self.exercise).one()
176
worksheet = req.store.find(Worksheet,
177
Worksheet.name == self.worksheet,
178
Worksheet.offering_id == Offering.id,
179
Offering.subject_id == Subject.id,
180
Subject.code == self.subject,
181
Offering.semester_id == Semester.id,
182
Semester.year == self.year,
183
Semester.semester == self.semester).one()
184
ivle.worksheet.save_exercise(req.store, req.user, exercise, worksheet,
185
unicode(text), datetime.datetime.now())
186
return {"result": "ok"}