~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to ivle/dispatch/__init__.py

ivle.webapp.tutorial: Port www/apps/tutorial to new framework.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# IVLE
2
 
# Copyright (C) 2007-2008 The University of Melbourne
 
1
# IVLE - Informatics Virtual Learning Environment
 
2
# Copyright (C) 2007-2009 The University of Melbourne
3
3
#
4
4
# This program is free software; you can redistribute it and/or modify
5
5
# it under the terms of the GNU General Public License as published by
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
17
17
 
18
 
# Module: dispatch
19
 
# Author: Matt Giuca
20
 
# Date: 11/12/2007
21
 
 
22
 
# This is a mod_python handler program. The correct way to call it is to have
23
 
# Apache send all requests to be handled by the module 'dispatch'.
24
 
 
25
 
# Top-level handler. Handles all requests to all pages in IVLE.
26
 
# Handles authentication (not authorization).
27
 
# Then passes the request along to the appropriate ivle app.
 
18
# Author: Matt Giuca, Will Grant
 
19
 
 
20
"""
 
21
This is a mod_python handler program. The correct way to call it is to have
 
22
Apache send all requests to be handled by the module 'dispatch'.
 
23
 
 
24
Top-level handler. Handles all requests to all pages in IVLE.
 
25
Handles authentication (not authorization).
 
26
Then passes the request along to the appropriate ivle app.
 
27
"""
28
28
 
29
29
import sys
30
30
import os
37
37
import time
38
38
 
39
39
import mod_python
40
 
from mod_python import apache, Cookie
 
40
import routes
41
41
 
42
42
from ivle import util
43
43
import ivle.conf
44
44
import ivle.conf.apps
 
45
from ivle.dispatch.request import Request
 
46
from ivle.dispatch import login
45
47
import apps
46
 
import login
47
48
import html
48
 
from request import Request
49
49
import plugins.console # XXX: Relies on www/ being in the Python path.
50
50
 
51
 
# List of cookies that IVLE uses (to be removed at logout)
52
 
ivle_cookies = ["ivleforumcookie", "clipboard"]
 
51
# XXX List of plugins, which will eventually be read in from conf
 
52
plugins_HACK = [
 
53
    'ivle.webapp.admin.user#Plugin',
 
54
    'ivle.webapp.browser#Plugin',
 
55
    'ivle.webapp.groups#Plugin',
 
56
    'ivle.webapp.tutorial#Plugin',
 
57
]
 
58
 
 
59
def get_routes_mapper():
 
60
    """
 
61
    Build a Mapper object for doing URL matching using 'routes', based on the
 
62
    plugins config.
 
63
    """
 
64
    m = routes.Mapper(explicit=True)
 
65
    for pluginstr in plugins_HACK:
 
66
        plugin_path, classname = pluginstr.split('#')
 
67
        # Load the plugin module from somewhere in the Python path
 
68
        # (Note that plugin_path is a fully-qualified Python module name).
 
69
        plugin = getattr(__import__(plugin_path, fromlist=[classname]),
 
70
            classname)
 
71
        # Establish a URL pattern for each element of plugin.urls
 
72
        for url in plugin.urls:
 
73
            routex = url[0]
 
74
            view_class = url[1]
 
75
            kwargs_dict = url[2] if len(url) >= 3 else {}
 
76
            m.connect(routex, view=view_class, **kwargs_dict)
 
77
    return m
53
78
 
54
79
def handler(req):
55
80
    """Handles a request which may be to anywhere in the site except media.
66
91
        # yet.
67
92
        handle_unknown_exception(apachereq, *sys.exc_info())
68
93
        # Tell Apache not to generate its own errors as well
69
 
        return apache.OK
 
94
        return mod_python.apache.OK
70
95
 
71
96
    # Run the main handler, and catch all exceptions
72
97
    try:
78
103
    except Exception:
79
104
        handle_unknown_exception(req, *sys.exc_info())
80
105
        # Tell Apache not to generate its own errors as well
81
 
        return apache.OK
 
106
        return mod_python.apache.OK
82
107
 
83
108
def handler_(req, apachereq):
84
109
    """
91
116
    if not req.publicmode:
92
117
        req.user = login.get_user_details(req)
93
118
 
 
119
    ### BEGIN New plugins framework ###
 
120
    # XXX This should be done ONCE per Python process, not per request.
 
121
    # (Wait till WSGI)
 
122
    # XXX No authentication is done here
 
123
    req.mapper = get_routes_mapper()
 
124
    matchdict = req.mapper.match(req.uri)
 
125
    if matchdict is not None:
 
126
        viewcls = matchdict['view']
 
127
        # Get the remaining arguments, less 'view', 'action' and 'controller'
 
128
        # (The latter two seem to be built-in, and we don't want them).
 
129
        kwargs = matchdict.copy()
 
130
        del kwargs['view']
 
131
        # Instantiate the view, which should be a BaseView class
 
132
        view = viewcls(req, **kwargs)
 
133
        # Render the output
 
134
        view.render(req)
 
135
        req.store.commit()
 
136
        return req.OK
 
137
    ### END New plugins framework ###
 
138
 
94
139
    # Check req.app to see if it is valid. 404 if not.
95
140
    if req.app is not None and req.app not in ivle.conf.apps.app_url:
96
 
        # Maybe it is a special app!
97
 
        if req.app == 'logout':
98
 
            logout(req)
99
 
        else:
100
 
            req.throw_error(Request.HTTP_NOT_FOUND,
101
 
                "There is no application called %s." % repr(req.app))
 
141
        req.throw_error(Request.HTTP_NOT_FOUND,
 
142
            "There is no application called %s." % repr(req.app))
102
143
 
103
144
    # Special handling for public mode - only allow the public app, call it
104
145
    # and get out.
170
211
    # Use req.throw_error to do that.
171
212
    return req.OK
172
213
 
173
 
def logout(req):
174
 
    """Log out the current user (if any) by destroying the session state.
175
 
    Then redirect to the top-level IVLE page."""
176
 
    session = req.get_session()
177
 
    session.invalidate()
178
 
    session.delete()
179
 
    # Invalidates all IVLE cookies
180
 
    all_cookies = Cookie.get_cookies(req)
181
 
    for cookie in all_cookies:
182
 
        if cookie in ivle_cookies:
183
 
            req.add_cookie(Cookie.Cookie(cookie,'',expires=1,path='/'))
184
 
    req.throw_redirect(util.make_path('')) 
185
 
 
186
214
def handle_unknown_exception(req, exc_type, exc_value, exc_traceback):
187
215
    """
188
216
    Given an exception that has just been thrown from IVLE, print its details
200
228
    # For some reason, some versions of mod_python have "_server" instead of
201
229
    # "main_server". So we check for both.
202
230
    try:
203
 
        admin_email = apache.main_server.server_admin
 
231
        admin_email = mod_python.apache.main_server.server_admin
204
232
    except AttributeError:
205
233
        try:
206
 
            admin_email = apache._server.server_admin
 
234
            admin_email = mod_python.apache._server.server_admin
207
235
        except AttributeError:
208
236
            admin_email = ""
209
237
    try:
211
239
        req.status = httpcode
212
240
    except AttributeError:
213
241
        httpcode = None
214
 
        req.status = apache.HTTP_INTERNAL_SERVER_ERROR
 
242
        req.status = mod_python.apache.HTTP_INTERNAL_SERVER_ERROR
 
243
    try:
 
244
        publicmode = req.publicmode
 
245
    except AttributeError:
 
246
        publicmode = True
215
247
    try:
216
248
        login = req.user.login
217
249
    except AttributeError:
218
250
        login = None
 
251
    try:
 
252
        role = req.user.role
 
253
    except AttributeError:
 
254
        role = None
219
255
 
220
256
    # Log File
221
257
    try:
311
347
 
312
348
        # Logging
313
349
        logging.error('%s\n%s'%(str(msg), tb))
314
 
 
 
350
        # Error messages are only displayed is the user is NOT a student,
 
351
        # or if there has been a problem logging the error message
 
352
        show_errors = (not publicmode) and ((login and \
 
353
                            str(role) != "student") or logfail)
315
354
        req.write("""<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"                 
316
355
        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">                                      
317
356
<html xmlns="http://www.w3.org/1999/xhtml">
318
357
<head><title>IVLE Internal Server Error</title></head>
319
358
<body>
320
359
<h1>IVLE Internal Server Error""")
321
 
        if (codename is not None
322
 
            and httpcode != apache.HTTP_INTERNAL_SERVER_ERROR):
323
 
            req.write(": %s" % cgi.escape(codename))
 
360
        if (show_errors):
 
361
            if (codename is not None
 
362
                        and httpcode != mod_python.apache.HTTP_INTERNAL_SERVER_ERROR):
 
363
                req.write(": %s" % cgi.escape(codename))
 
364
        
324
365
        req.write("""</h1>
325
366
<p>An error has occured which is the fault of the IVLE developers or
326
 
administration.</p>
 
367
administration. The developers have been notified.</p>
327
368
""")
328
 
        if msg is not None:
329
 
            req.write("<p>%s</p>\n" % cgi.escape(msg))
330
 
        if httpcode is not None:
331
 
            req.write("<p>(HTTP error code %d)</p>\n" % httpcode)
332
 
        req.write("""
333
 
<p>Please report this to <a href="mailto:%s">%s</a> (the system
334
 
administrator). Include the following information:</p>
335
 
""" % (cgi.escape(admin_email), cgi.escape(admin_email)))
 
369
        if (show_errors):
 
370
            if msg is not None:
 
371
                req.write("<p>%s</p>\n" % cgi.escape(msg))
 
372
            if httpcode is not None:
 
373
                req.write("<p>(HTTP error code %d)</p>\n" % httpcode)
 
374
            req.write("""
 
375
    <p>Please report this to <a href="mailto:%s">%s</a> (the system
 
376
    administrator). Include the following information:</p>
 
377
    """ % (cgi.escape(admin_email), cgi.escape(admin_email)))
336
378
 
337
 
        req.write("<pre>\n%s\n</pre>\n"%cgi.escape(tb))
338
 
        if logfail:
339
 
            req.write("<p>Warning: Could not open Error Log: '%s'</p>\n"
340
 
                %cgi.escape(logfile))
 
379
            req.write("<pre>\n%s\n</pre>\n"%cgi.escape(tb))
 
380
            if logfail:
 
381
                req.write("<p>Warning: Could not open Error Log: '%s'</p>\n"
 
382
                    %cgi.escape(logfile))
341
383
        req.write("</body></html>")