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

# IVLE

# Copyright (C) 2007-2008 The University of Melbourne

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation; either version 2 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

# Module: dispatch

# Author: Matt Giuca

# Date: 11/12/2007

# This is a mod_python handler program. The correct way to call it is to have

# Apache send all requests to be handled by the module 'dispatch'.

# Top-level handler. Handles all requests to all pages in IVLE.

# Handles authentication (not authorization).

# Then passes the request along to the appropriate ivle app.

import mod_python

from mod_python import apache

import os

import os.path

import conf

import conf.apps

import apps

from request import Request

import html

from common import util

def handler(req):

    """Handles a request which may be to anywhere in the site except media.

    Intended to be called by mod_python, as a handler.

    req: An Apache request object.

    """

    # Make the request object into an IVLE request which can be passed to apps

    apachereq = req

    req = Request(req, html.write_html_head)

    # Check req.app to see if it is valid. 404 if not.

    if req.app is not None and req.app not in conf.apps.app_url:

        # TODO: Nicer 404 message?

        req.throw_error(Request.HTTP_NOT_FOUND)

    # app is the App object for the chosen app

    if req.app is None:

        app = conf.apps.app_url[conf.default_app]

    else:

        app = conf.apps.app_url[req.app]

    # Check if app requires auth. If so, perform authentication and login.

    if app.requireauth:

        # TODO: Perform authentication

        pass

    # If user did not specify an app, HTTP redirect to default app and exit.

    if req.app is None:

        req.throw_redirect(util.make_path(conf.default_app))

    # Set the default title to the app's tab name, if any. Otherwise URL name.

    if app.name is not None:

        req.title = app.name

    else:

        req.title = req.app

    # Call the specified app with the request object

    apps.call_app(app.dir, req)

    # MAKE SURE we write the HTTP (and possibly HTML) header. This

    # wouldn't happen if nothing else ever got written, so we have to make

    # sure.

    req.ensure_headers_written()

    # When done, write out the HTML footer if the app has requested it

    if req.write_html_head_foot:

        html.write_html_foot(req)

    # Have Apache output its own HTML code if non-200 status codes were found

    return req.status