bluechips/config/middleware.py

   1 """Pylons middleware initialization"""
   2 from beaker.middleware import CacheMiddleware, SessionMiddleware
   3 from paste.cascade import Cascade
   4 from paste.registry import RegistryManager
   5 from paste.urlparser import StaticURLParser
   6 from paste.deploy.converters import asbool
   7 from pylons import config
   8 from pylons.middleware import ErrorHandler, StaticJavascripts, \
   9     StatusCodeRedirect
  10 from pylons.wsgiapp import PylonsApp
  11 from routes.middleware import RoutesMiddleware
  12 from paste import httpexceptions
  13
  14 from tw.api import make_middleware
  15
  16 from bluechips.config.environment import load_environment
  17
  18 def make_app(global_conf, full_stack=True, **app_conf):
  19     """Create a Pylons WSGI application and return it
  20
  21     ``global_conf``
  22         The inherited configuration for this application. Normally from
  23         the [DEFAULT] section of the Paste ini file.
  24
  25     ``full_stack``
  26         Whether or not this application provides a full WSGI stack (by
  27         default, meaning it handles its own exceptions and errors).
  28         Disable full_stack when this application is "managed" by
  29         another WSGI middleware.
  30
  31     ``app_conf``
  32         The application's local configuration. Normally specified in the
  33         [app:<name>] section of the Paste ini file (where <name>
  34         defaults to main).
  35     """
  36     # Configure the Pylons environment
  37     load_environment(global_conf, app_conf)
  38
  39     # The Pylons WSGI app
  40     app = PylonsApp()
  41
  42     # CUSTOM MIDDLEWARE HERE (filtered by error handling middlewares)
  43     app = httpexceptions.make_middleware(app, global_conf)
  44
  45     # Routing/Session/Cache Middleware
  46     app = RoutesMiddleware(app, config['routes.map'])
  47     app = SessionMiddleware(app, config)
  48     app = CacheMiddleware(app, config)
  49
  50     app = make_middleware(app, {
  51             'toscawidgets.framework': 'pylons',
  52             'toscawidgets.framework.default_view': 'mako',
  53             'toscawidgets.middleware.inject_resources': True
  54             })
  55
  56     if asbool(full_stack):
  57         # Handle Python exceptions
  58         app = ErrorHandler(app, global_conf, **config['pylons.errorware'])
  59
  60         # Display error documents for 401, 403, 404 status codes (and
  61         # 500 when debug is disabled)
  62         if asbool(config['debug']):
  63             app = StatusCodeRedirect(app)
  64         else:
  65             app = StatusCodeRedirect(app, [400, 401, 403, 404, 500])
  66
  67     # Establish the Registry for this application
  68     app = RegistryManager(app)
  69
  70     # Static files (If running in production, and Apache or another web
  71     # server is handling this static content, remove the following 3 lines)
  72     static_app = StaticURLParser(config['pylons.paths']['static_files'])
  73     app = Cascade([static_app, app])
  74     return app