61
43
TIMESTAMP_FORMAT = '%Y-%m-%d %H:%M:%S'
65
"""Handler for Ajax backend TutorialService app."""
66
# Set request attributes
67
req.write_html_head_foot = False # No HTML
70
req.throw_error(req.HTTP_BAD_REQUEST)
71
fields = req.get_fieldstorage()
72
act = fields.getfirst('action')
73
exercise = fields.getfirst('exercise')
74
if act is None or exercise is None:
75
req.throw_error(req.HTTP_BAD_REQUEST)
77
exercise = exercise.value
79
if act == 'save' or act == 'test':
81
if req.method != 'POST':
82
req.throw_error(req.HTTP_BAD_REQUEST)
84
code = fields.getfirst('code')
86
req.throw_error(req.HTTP_BAD_REQUEST)
90
handle_save(req, exercise, code, fields)
92
handle_test(req, exercise, code, fields)
93
elif act == 'getattempts':
94
handle_getattempts(req, exercise)
95
elif act == 'getattempt':
96
date = fields.getfirst('date')
98
req.throw_error(req.HTTP_BAD_REQUEST)
100
# Convert into a struct_time
101
# The time *should* be in the same format as the DB (since it should
102
# be bounced back to us from the getattempts output). Assume this.
45
class AttemptsRESTView(JSONRESTView):
46
'''REST view of a user's attempts at an exercise.'''
48
def __init__(self, req, subject, year, semester, worksheet,
50
self.user = ivle.database.User.get_by_login(req.store, username)
54
self.worksheet_exercise = req.store.find(WorksheetExercise,
55
WorksheetExercise.exercise_id == exercise,
56
WorksheetExercise.worksheet_id == Worksheet.id,
57
Worksheet.offering_id == Offering.id,
58
Offering.subject_id == Subject.id,
59
Subject.code == subject,
60
Offering.semester_id == Semester.id,
61
Semester.year == year,
62
Semester.semester == semester).one()
64
self.context = self.user # XXX: Not quite right.
66
@require_permission('edit')
68
"""Handles a GET Attempts action."""
69
attempts = req.store.find(ExerciseAttempt,
70
ExerciseAttempt.ws_ex_id == self.worksheet_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,
84
Exercise.id == self.worksheet_exercise.exercise_id).one()
88
# Start a console to run the tests on
89
jail_path = os.path.join(ivle.conf.jail_base, req.user.login)
90
working_dir = os.path.join("/home", req.user.login)
91
cons = ivle.console.Console(req.user.unixid, jail_path, working_dir)
93
# Parse the file into a exercise object using the test suite
94
exercise_obj = ivle.webapp.tutorial.test.parse_exercise_file(
97
# Run the test cases. Get the result back as a JSONable object.
99
test_results = exercise_obj.run_tests(data['code'])
104
attempt = ivle.database.ExerciseAttempt(user=req.user,
105
worksheet_exercise = self.worksheet_exercise,
106
date = datetime.datetime.now(),
107
complete = test_results['passed'],
108
text = unicode(data['code'])
111
req.store.add(attempt)
113
# Query the DB to get an updated score on whether or not this problem
114
# has EVER been completed (may be different from "passed", if it has
115
# been completed before), and the total number of attempts.
116
completed, attempts = ivle.worksheet.get_exercise_status(req.store,
117
req.user, self.worksheet_exercise)
118
test_results["completed"] = completed
119
test_results["attempts"] = attempts
124
class AttemptRESTView(JSONRESTView):
125
'''REST view of an exercise attempt.'''
127
def __init__(self, req, subject, year, semester, worksheet, exercise,
129
# TODO: Find exercise within worksheet.
130
user = ivle.database.User.get_by_login(req.store, username)
104
135
date = datetime.datetime.strptime(date, TIMESTAMP_FORMAT)
105
136
except ValueError:
106
# Date was not in correct format
107
req.throw_error(req.HTTP_BAD_REQUEST)
108
handle_getattempt(req, exercise, date)
110
req.throw_error(req.HTTP_BAD_REQUEST)
112
def handle_save(req, exercisename, code, fields):
113
"""Handles a save action. This saves the user's code without executing it.
115
# Need to open JUST so we know this is a real exercise.
116
# (This avoids users submitting code for bogus exercises).
117
exercisefile = util.open_exercise_file(exercisename)
118
if exercisefile is None:
119
req.throw_error(req.HTTP_NOT_FOUND,
120
"The exercise was not found.")
123
exercise = ivle.database.Exercise.get_by_name(req.store, exercisename)
124
ivle.worksheet.save_exercise(req.store, req.user, exercise,
125
unicode(code), datetime.datetime.now())
128
req.write('{"result": "ok"}')
131
def handle_test(req, exercisesrc, code, fields):
132
"""Handles a test action."""
134
exercisefile = util.open_exercise_file(exercisesrc)
135
if exercisefile is None:
136
req.throw_error(req.HTTP_NOT_FOUND,
137
"The exercise was not found.")
139
# Start a console to run the tests on
140
jail_path = os.path.join(ivle.conf.jail_base, req.user.login)
141
working_dir = os.path.join("/home", req.user.login)
142
cons = console.Console(req.user.unixid, jail_path, working_dir)
144
# Parse the file into a exercise object using the test suite
145
exercise_obj = test.parse_exercise_file(exercisefile, cons)
148
# Run the test cases. Get the result back as a JSONable object.
150
test_results = exercise_obj.run_tests(code)
155
# Get the Exercise from the database
156
exercise = ivle.database.Exercise.get_by_name(req.store, exercisesrc)
158
attempt = ivle.database.ExerciseAttempt(user=req.user,
160
date=datetime.datetime.now(),
161
complete=test_results['passed'],
162
text=unicode(code)) # XXX
164
req.store.add(attempt)
166
# Query the DB to get an updated score on whether or not this problem
167
# has EVER been completed (may be different from "passed", if it has
168
# been completed before), and the total number of attempts.
169
completed, attempts = ivle.worksheet.get_exercise_status(req.store,
171
test_results["completed"] = completed
172
test_results["attempts"] = attempts
174
req.write(cjson.encode(test_results))
176
def handle_getattempts(req, exercisename):
177
"""Handles a getattempts action."""
178
exercise = ivle.database.Exercise.get_by_name(req.store, exercisename)
179
attempts = ivle.worksheet.get_exercise_attempts(req.store, req.user,
180
exercise, allow_inactive=HISTORY_ALLOW_INACTIVE)
181
# attempts is a list of ExerciseAttempt objects. Convert to dictionaries.
182
time_fmt = lambda dt: datetime.datetime.strftime(dt, TIMESTAMP_FORMAT)
183
attempts = [{'date': time_fmt(a.date), 'complete': a.complete}
185
req.write(cjson.encode(attempts))
187
def handle_getattempt(req, exercisename, date):
188
"""Handles a getattempts action. Date is a datetime.datetime."""
189
exercise = ivle.database.Exercise.get_by_name(req.store, exercisename)
190
attempt = ivle.worksheet.get_exercise_attempt(req.store, req.user,
191
exercise, as_of=date, allow_inactive=HISTORY_ALLOW_INACTIVE)
192
if attempt is not None:
193
attempt = attempt.text
194
# attempt may be None; will write "null"
195
req.write(cjson.encode({'code': attempt}))
139
worksheet_exercise = req.store.find(WorksheetExercise,
140
WorksheetExercise.exercise_id == exercise,
141
WorksheetExercise.worksheet_id == Worksheet.id,
142
Worksheet.identifier == worksheet,
143
Worksheet.offering_id == Offering.id,
144
Offering.subject_id == Subject.id,
145
Subject.code == subject,
146
Offering.semester_id == Semester.id,
147
Semester.year == year,
148
Semester.semester == semester).one()
150
attempt = ivle.worksheet.get_exercise_attempt(req.store, user,
151
worksheet_exercise, as_of=date,
152
allow_inactive=HISTORY_ALLOW_INACTIVE)
157
self.context = attempt
159
@require_permission('view')
161
return {'code': self.context.text}
164
class ExerciseRESTView(JSONRESTView):
165
'''REST view of an exercise.'''
167
def get_permissions(self, user):
168
# XXX: Do it properly.
169
# XXX: Does any user have the ability to save as themselves?
170
# XXX: Does a user EVER have permission to save as another user?
176
@named_operation('save')
177
def save(self, req, text):
178
# Find the appropriate WorksheetExercise to save to. If its not found,
179
# the user is submitting against a non-existant worksheet/exercise
180
worksheet_exercise = req.store.find(WorksheetExercise,
181
WorksheetExercise.exercise_id == self.exercise,
182
WorksheetExercise.worksheet_id == Worksheet.id,
183
Worksheet.offering_id == Offering.id,
184
Offering.subject_id == Subject.id,
185
Subject.code == self.subject,
186
Offering.semester_id == Semester.id,
187
Semester.year == self.year,
188
Semester.semester == self.semester).one()
190
if worksheet_exercise is None:
193
old_save = req.store.find(ExerciseSave,
194
ExerciseSave.ws_ex_id == worksheet_exercise.id,
195
ExerciseSave.user == req.user).one()
197
#Overwrite the old, or create a new if there isn't one
199
new_save = ExerciseSave()
200
req.store.add(new_save)
204
new_save.worksheet_exercise = worksheet_exercise
205
new_save.user = req.user
206
new_save.text = unicode(text)
207
new_save.date = datetime.datetime.now()
209
return {"result": "ok"}
212
def generate_exerciselist(worksheet, req, worksheetdata):
213
"""Runs through the worksheetstream, generating the appropriate
214
WorksheetExercises, and de-activating the old ones."""
216
# Turns the worksheet into an xml stream, and then finds all the
217
# exercise nodes in the stream.
218
worksheetdata = genshi.XML(worksheetdata)
219
for kind, data, pos in worksheetdata:
220
if kind is genshi.core.START:
221
# Data is a tuple of tag name and a list of name->value tuples
222
if data[0] == 'exercise':
228
if attr[0] == 'optional':
229
optional = attr[1] == 'true'
231
exercises.append((src, optional))
233
# Set all current worksheet_exercises to be inactive
234
db_worksheet_exercises = req.store.find(WorksheetExercise,
235
WorksheetExercise.worksheet_id == worksheet.id)
236
for worksheet_exercise in db_worksheet_exercises:
237
worksheet_exercise.active = False
239
for exerciseid, optional in exercises:
240
worksheet_exercise = req.store.find(WorksheetExercise,
241
WorksheetExercise.worksheet_id == worksheet.id,
242
Exercise.id == WorksheetExercise.exercise_id,
243
Exercise.id == exerciseid).one()
244
if worksheet_exercise is None:
245
exercise = req.store.find(Exercise,
246
Exercise.id == exerciseid
250
worksheet_exercise = WorksheetExercise()
251
worksheet_exercise.worksheet_id = worksheet.id
252
worksheet_exercise.exercise_id = exercise.id
253
req.store.add(worksheet_exercise)
254
worksheet_exercise.active = True
255
worksheet_exercise.seq_no = ex_num
256
worksheet_exercise.optional = optional
259
# Note that this is the view of an existing worksheet. Creation is handled
260
# by OfferingRESTView (as offerings have worksheets)
261
class WorksheetRESTView(JSONRESTView):
262
"""View used to update a worksheet."""
264
def get_permissions(self, user):
265
# XXX: Do it properly.
266
# XXX: Lecturers should be allowed to add worksheets Only to subjects
267
# under their control
269
if user.rolenm == 'admin':
276
def __init__(self, req, **kwargs):
278
self.worksheet = kwargs['worksheet']
279
self.subject = kwargs['subject']
280
self.year = kwargs['year']
281
self.semester = kwargs['semester']
283
self.context = req.store.find(Worksheet,
284
Worksheet.identifier == self.worksheet,
285
Worksheet.offering_id == Offering.id,
286
Offering.subject_id == Subject.id,
287
Subject.code == self.subject,
288
Offering.semester_id == Semester.id,
289
Semester.year == self.year,
290
Semester.semester == self.semester).one()
292
if self.context is None:
295
@named_operation('save')
296
def save(self, req, name, assessable, data, format):
297
"""Takes worksheet data and saves it."""
298
generate_exerciselist(self.context, req, data)
300
self.context.name = unicode(name)
301
self.context.assessable = self.convert_bool(assessable)
302
self.context.data = unicode(data)
303
self.context.format = unicode(format)
305
return {"result": "ok"}
307
class WorksheetsRESTView(JSONRESTView):
308
"""View used to update and create Worksheets."""
310
def get_permissions(self, user):
311
# XXX: Do it properly.
312
# XXX: Lecturers should be allowed to add worksheets Only to subjects
313
# under their control
315
if user.rolenm == 'admin':
322
def __init__(self, req, **kwargs):
324
self.subject = kwargs['subject']
325
self.year = kwargs['year']
326
self.semester = kwargs['semester']
328
self.context = req.store.find(Offering,
329
Offering.subject_id == Subject.id,
330
Subject.code == self.subject,
331
Offering.semester_id == Semester.id,
332
Semester.year == self.year,
333
Semester.semester == self.semester).one()
335
if self.context is None:
338
@named_operation('edit')
339
def add_worksheet(self, req, identifier, name, assessable, data, format):
340
"""Takes worksheet data and adds it."""
342
new_worksheet = Worksheet()
343
new_worksheet.seq_no = self.context.worksheets.count()
344
# Setting new_worksheet.offering implicitly adds new_worksheet,
345
# hence worksheets.count MUST be called above it
346
new_worksheet.offering = self.context
347
new_worksheet.identifier = unicode(identifier)
348
new_worksheet.name = unicode(name)
349
new_worksheet.assessable = self.convert_bool(assessable)
350
new_worksheet.data = unicode(data)
351
new_worksheet.format = unicode(format)
353
# This call is added for clarity, as the worksheet is implicitly added.
354
req.store.add(new_worksheet)
356
generate_exerciselist(new_worksheet, req, data)
358
return {"result": "ok"}
360
@named_operation('edit')
361
def move_up(self, req, worksheetid):
362
"""Takes a list of worksheet-seq_no pairs and updates their
363
corresponding Worksheet objects to match."""
365
worksheet_below = req.store.find(Worksheet,
366
Worksheet.offering_id == self.context.id,
367
Worksheet.identifier == unicode(worksheetid)).one()
368
if worksheet_below is None:
369
raise NotFound('worksheet_below')
370
worksheet_above = req.store.find(Worksheet,
371
Worksheet.offering_id == self.context.id,
372
Worksheet.seq_no == (worksheet_below.seq_no - 1)).one()
373
if worksheet_above is None:
374
raise NotFound('worksheet_above')
376
worksheet_below.seq_no = worksheet_below.seq_no - 1
377
worksheet_above.seq_no = worksheet_above.seq_no + 1
379
return {'result': 'ok'}
381
@named_operation('edit')
382
def move_down(self, req, worksheetid):
383
"""Takes a list of worksheet-seq_no pairs and updates their
384
corresponding Worksheet objects to match."""
386
worksheet_above = req.store.find(Worksheet,
387
Worksheet.offering_id == self.context.id,
388
Worksheet.identifier == unicode(worksheetid)).one()
389
if worksheet_above is None:
390
raise NotFound('worksheet_below')
391
worksheet_below = req.store.find(Worksheet,
392
Worksheet.offering_id == self.context.id,
393
Worksheet.seq_no == (worksheet_above.seq_no + 1)).one()
394
if worksheet_below is None:
395
raise NotFound('worksheet_above')
397
worksheet_below.seq_no = worksheet_below.seq_no - 1
398
worksheet_above.seq_no = worksheet_above.seq_no + 1
400
return {'result': 'ok'}