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
# Author: Matt Giuca, Nick Chadwick
20
'''AJAX backend for the tutorial application.'''
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
# "action". One of the tutorialservice actions.
31
# "exercise" - The path to a exercise file (including the .xml extension),
32
# relative to the subjects base directory.
33
# action "save" or "test" (POST only):
34
# "code" - Full text of the student's code being submitted.
35
# action "getattempts": No arguments. Returns a list of
36
# {'date': 'formatted_date', 'complete': bool} dicts.
37
# action "getattempt":
38
# "date" - Formatted date. Gets most recent attempt before (and including)
40
# Returns JSON string containing code, or null.
42
# Returns a JSON response string indicating the results.
51
from ivle import console
27
52
import ivle.database
28
53
import ivle.worksheet
30
import ivle.webapp.tutorial.test
55
import test # XXX: Really .test, not real test.
32
from ivle.webapp.base.rest import (JSONRESTView, named_operation,
34
from ivle.webapp.errors import NotFound
57
from ivle.webapp.base.rest import JSONRESTView
59
from ivle.webapp.base.rest import named_operation
36
61
# If True, getattempts or getattempt will allow browsing of inactive/disabled
37
62
# attempts. If False, will not allow this.
43
68
class AttemptsRESTView(JSONRESTView):
44
'''REST view of a user's attempts at an exercise.'''
45
def __init__(self, req, subject, worksheet, exercise, username):
46
# TODO: Find exercise within worksheet.
47
self.user = ivle.database.User.get_by_login(req.store, username)
50
self.exercise = exercise
51
self.context = self.user # XXX: Not quite right.
53
@require_permission('edit')
70
Class to return a list of attempts for a given exercise, or add an Attempt
54
72
def GET(self, req):
55
73
"""Handles a GET Attempts action."""
56
74
exercise = ivle.database.Exercise.get_by_name(req.store,
76
user = ivle.database.User.get_by_login(req.store, self.username)
59
attempts = ivle.worksheet.get_exercise_attempts(req.store, self.user,
78
attempts = ivle.worksheet.get_exercise_attempts(req.store, user,
60
79
exercise, allow_inactive=HISTORY_ALLOW_INACTIVE)
61
80
# attempts is a list of ExerciseAttempt objects. Convert to dictionaries
62
81
time_fmt = lambda dt: datetime.datetime.strftime(dt, TIMESTAMP_FORMAT)
63
82
attempts = [{'date': time_fmt(a.date), 'complete': a.complete}
84
attempts.append(self.exercise)
69
@require_permission('edit')
70
88
def PUT(self, req, data):
71
''' Tests the given submission '''
72
exercisefile = ivle.util.open_exercise_file(self.exercise)
90
exercisefile = util.open_exercise_file(self.exercise)
73
91
if exercisefile is None:
92
req.throw_error(req.HTTP_NOT_FOUND,
93
"The exercise was not found.")
76
95
# Start a console to run the tests on
77
96
jail_path = os.path.join(ivle.conf.jail_base, req.user.login)
78
97
working_dir = os.path.join("/home", req.user.login)
79
cons = ivle.console.Console(req.user.unixid, jail_path, working_dir)
98
cons = console.Console(req.user.unixid, jail_path, working_dir)
81
100
# Parse the file into a exercise object using the test suite
82
exercise_obj = ivle.webapp.tutorial.test.parse_exercise_file(
101
exercise_obj = test.parse_exercise_file(exercisefile, cons)
84
102
exercisefile.close()
86
104
# Run the test cases. Get the result back as a JSONable object.
88
test_results = exercise_obj.run_tests(data['code'])
106
test_results = exercise_obj.run_tests(code)
90
108
# Close the console
93
111
# Get the Exercise from the database
94
exercise = ivle.database.Exercise.get_by_name(req.store, self.exercise)
112
exercise = ivle.database.Exercise.get_by_name(req.store, exercisesrc)
96
114
attempt = ivle.database.ExerciseAttempt(user=req.user,
97
115
exercise=exercise,
98
116
date=datetime.datetime.now(),
99
117
complete=test_results['passed'],
101
text=unicode(data['code']))
118
text=unicode(code)) # XXX
103
120
req.store.add(attempt)
105
122
# Query the DB to get an updated score on whether or not this problem
106
123
# has EVER been completed (may be different from "passed", if it has
107
124
# been completed before), and the total number of attempts.
111
128
test_results["attempts"] = attempts
113
130
return test_results
116
133
class AttemptRESTView(JSONRESTView):
117
'''REST view of an exercise attempt.'''
119
def __init__(self, req, subject, worksheet, exercise, username, date):
120
# TODO: Find exercise within worksheet.
121
user = ivle.database.User.get_by_login(req.store, username)
126
date = datetime.datetime.strptime(date, TIMESTAMP_FORMAT)
130
exercise = ivle.database.Exercise.get_by_name(req.store, exercise)
131
attempt = ivle.worksheet.get_exercise_attempt(req.store, user,
135
View used to extract the data of a specified attempt
139
# Get an actual date object, rather than a string
140
date = datetime.datetime.strptime(self.date, TIMESTAMP_FORMAT)
142
exercise = ivle.database.Exercise.get_by_name(req.store, self.exercise)
143
attempt = ivle.worksheet.get_exercise_attempt(req.store, req.user,
132
144
exercise, as_of=date, allow_inactive=HISTORY_ALLOW_INACTIVE)
137
self.context = attempt
139
@require_permission('view')
141
return {'code': self.context.text}
145
if attempt is not None:
146
attempt = attempt.text
147
# attempt may be None; will write "null"
148
return {'code': attempt}
144
150
class ExerciseRESTView(JSONRESTView):
145
'''REST view of an exercise.'''
147
def get_permissions(self, user):
148
# XXX: Do it properly.
154
@named_operation('save')
155
def save(self, req, text):
152
Handles a save action. This saves the user's code without executing it.
155
def save(self, req, user, text):
156
156
# Need to open JUST so we know this is a real exercise.
157
157
# (This avoids users submitting code for bogus exercises).
158
exercisefile = ivle.util.open_exercise_file(self.exercise)
158
exercisefile = util.open_exercise_file(self.exercise)
159
159
if exercisefile is None:
160
req.throw_error(req.HTTP_NOT_FOUND,
161
"The exercise was not found.")
161
162
exercisefile.close()
163
164
exercise = ivle.database.Exercise.get_by_name(req.store, self.exercise)
164
165
ivle.worksheet.save_exercise(req.store, req.user, exercise,
165
unicode(text), datetime.datetime.now())
166
unicode(code), datetime.datetime.now())
166
168
return {"result": "ok"}