1
# IVLE - Informatics Virtual Learning Environment
2
# Copyright (C) 2007-2009 The University of Melbourne
4
# This program is free software; you can redistribute it and/or modify
5
# it under the terms of the GNU General Public License as published by
6
# the Free Software Foundation; either version 2 of the License, or
7
# (at your option) any later version.
9
# This program is distributed in the hope that it will be useful,
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
# GNU General Public License for more details.
14
# You should have received a copy of the GNU General Public License
15
# along with this program; if not, write to the Free Software
16
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
# Author: Matt Giuca, Will Grant
21
import formencode.validators
22
from genshi.filters import HTMLFormFiller
24
from ivle.webapp.base.rest import JSONRESTView, require_permission
25
from ivle.webapp.base.xhtml import XHTMLView
26
from ivle.webapp.base.plugins import ViewPlugin, MediaPlugin
27
from ivle.webapp.errors import NotFound, Unauthorized
32
# List of fields returned as part of the user JSON dictionary
33
# (as returned by the get_user action)
35
"login", "state", "unixid", "email", "nick", "fullname",
36
"admin", "studentid", "acct_exp", "pass_exp", "last_login",
40
class UserRESTView(JSONRESTView):
42
A REST interface to the user object.
44
def __init__(self, req, login):
45
super(UserRESTView, self).__init__(self, req, login)
46
self.context = ivle.database.User.get_by_login(req.store, login)
47
if self.context is None:
50
@require_permission('view')
53
user = ivle.util.object_to_dict(user_fields_list, self.context)
54
# Convert time stamps to nice strings
55
for k in 'pass_exp', 'acct_exp', 'last_login':
56
if user[k] is not None:
57
user[k] = unicode(user[k])
59
user['local_password'] = self.context.passhash is not None
62
class UserEditSchema(formencode.Schema):
63
nick = formencode.validators.UnicodeString(not_empty=True)
64
email = formencode.validators.Email(not_empty=False,
67
class UserEditView(XHTMLView):
68
"""A form to change a user's details."""
69
template = 'templates/user-edit.html'
73
def __init__(self, req, login):
74
self.context = ivle.database.User.get_by_login(req.store, login)
75
if self.context is None:
78
def filter(self, stream, ctx):
79
return stream | HTMLFormFiller(data=ctx['data'])
81
def populate(self, req, ctx):
82
if req.method == 'POST':
83
data = dict(req.get_fieldstorage())
85
validator = UserEditSchema()
86
data = validator.to_python(data, state=req)
87
self.context.nick = data['nick']
88
self.context.email = unicode(data['email']) if data['email'] \
91
req.throw_redirect(req.uri)
92
except formencode.Invalid, e:
93
errors = e.unpack_errors()
95
data = {'nick': self.context.nick,
96
'email': self.context.email
100
ctx['format_datetime'] = ivle.date.make_date_nice
101
ctx['format_datetime_short'] = ivle.date.format_datetime_for_paragraph
104
ctx['user'] = self.context
106
ctx['errors'] = errors
108
class UserAdminSchema(formencode.Schema):
109
admin = formencode.validators.StringBoolean(if_missing=False)
110
fullname = formencode.validators.UnicodeString(not_empty=True)
111
studentid = formencode.validators.UnicodeString(not_empty=False,
115
class UserAdminView(XHTMLView):
116
"""A form for admins to change more of a user's details."""
117
template = 'templates/user-admin.html'
120
def __init__(self, req, login):
121
self.context = ivle.database.User.get_by_login(req.store, login)
122
if self.context is None:
125
def authorize(self, req):
126
"""Only allow access if the requesting user is an admin."""
127
return req.user.admin
129
def filter(self, stream, ctx):
130
return stream | HTMLFormFiller(data=ctx['data'])
132
def populate(self, req, ctx):
133
if req.method == 'POST':
134
data = dict(req.get_fieldstorage())
136
validator = UserAdminSchema()
137
data = validator.to_python(data, state=req)
139
self.context.admin = data['admin']
140
self.context.fullname = data['fullname'] \
141
if data['fullname'] else None
142
self.context.studentid = data['studentid'] \
143
if data['studentid'] else None
145
req.throw_redirect(req.uri)
146
except formencode.Invalid, e:
147
errors = e.unpack_errors()
149
data = {'admin': self.context.admin,
150
'fullname': self.context.fullname,
151
'studentid': self.context.studentid,
156
ctx['user'] = self.context
158
ctx['errors'] = errors
160
class PasswordChangeView(XHTMLView):
161
"""A form to change a user's password, with knowledge of the old one."""
162
template = 'templates/user-password-change.html'
166
def __init__(self, req, login):
167
self.context = ivle.database.User.get_by_login(req.store, login)
168
if self.context is None:
171
def authorize(self, req):
172
"""Only allow access if the requesting user holds the permission,
173
and the target user has a password set. Otherwise we might be
174
clobbering external authn.
176
return super(PasswordChangeView, self).authorize(req) and \
177
self.context.passhash is not None
179
def populate(self, req, ctx):
181
if req.method == 'POST':
182
data = dict(req.get_fieldstorage())
183
if data.get('old_password') is None or \
184
not self.context.authenticate(data.get('old_password')):
185
error = 'Incorrect password.'
186
elif data.get('new_password') != data.get('new_password_again'):
187
error = 'New passwords do not match.'
188
elif not data.get('new_password'):
189
error = 'New password cannot be empty.'
191
self.context.password = data['new_password']
193
req.throw_redirect(req.uri)
196
ctx['user'] = self.context
199
class PasswordResetView(XHTMLView):
200
"""A form to reset a user's password, without knowledge of the old one."""
201
template = 'templates/user-password-reset.html'
204
def __init__(self, req, login):
205
self.context = ivle.database.User.get_by_login(req.store, login)
206
if self.context is None:
209
def authorize(self, req):
210
"""Only allow access if the requesting user is an admin."""
211
return req.user.admin
213
def populate(self, req, ctx):
215
if req.method == 'POST':
216
data = dict(req.get_fieldstorage())
217
if data.get('new_password') != data.get('new_password_again'):
218
error = 'New passwords do not match.'
219
elif not data.get('new_password'):
220
error = 'New password cannot be empty.'
222
self.context.password = data['new_password']
224
req.throw_redirect(req.uri)
226
ctx['user'] = self.context
229
class Plugin(ViewPlugin, MediaPlugin):
231
The Plugin class for the user plugin.
233
# Magic attribute: urls
234
# Sequence of pairs/triples of
235
# (regex str, handler class, kwargs dict)
236
# The kwargs dict is passed to the __init__ of the view object
238
('~:login/+edit', UserEditView),
239
('~:login/+admin', UserAdminView),
240
('~:login/+changepassword', PasswordChangeView),
241
('~:login/+resetpassword', PasswordResetView),
242
('api/~:login', UserRESTView),