Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

454 lines (370 sloc) 18.498 kb
"""Configuration object and defaults setup
The PylonsConfig object is initialized in pylons projects inside the
:file:`config/` module. Importing the :data:`config`
object from module causes the PylonsConfig object to be created, and
setup in app-safe manner so that multiple apps being setup avoid
After importing :data:`config`, the project should then call
:meth:`~PylonsConfig.init_app` with the appropriate options to setup
the configuration. In the config data passed with
:meth:`~PylonsConfig.init_app`, various defaults are set use with Paste
and Routes.
import copy
import logging
import os
import warnings
from paste.config import DispatchingConfig
from paste.deploy.converters import asbool
import pylons.legacy
import pylons.templating
from webhelpers.mimehelper import MIMETypes
default_template_engine = 'mako'
request_defaults = dict(charset='utf-8', errors='replace',
decode_param_names=False, language='en-us')
response_defaults = dict(content_type='text/html',
charset='utf-8', errors='strict',
headers={'Cache-Control': 'no-cache',
'Pragma': 'no-cache'})
log = logging.getLogger(__name__)
class PylonsConfig(DispatchingConfig):
"""Pylons configuration object
The Pylons configuration object is a per-application instance
object that retains the information regarding the global and app
conf's as well as per-application instance specific data such as
the mapper, and the paths for this instance.
The config object is available in your application as the Pylons
global :data:`pylons.config`. For example::
from pylons import config
template_paths = config['pylons.paths']['templates']
There's several useful keys of the config object most people will
be interested in:
Full dict of template options that any TG compatible plugin
should be able to parse. Comes with basic config needed for
Genshi, Mako, Myghty, and Kid.
A dict of absolute paths that were defined in the applications
``config/`` module.
Dict of environ keys for where in the environ to pickup various
objects for registering with Pylons. If these are present then
PylonsApp will use them from environ rather than using default
middleware from Beaker. Valid keys are: ``session, cache``
List of template engines to configure. The first one in the
list will be configured as the default template engine. Each
item in the list is a dict indicating how to configure the
template engine with keys:
``engine``, ``template_root``, ``template_options``, and
Deprecated: Use the response_settings dict instead.
Default character encoding specified to the browser via the
'charset' parameter of the HTTP response's Content-Type header.
Whether or not the ``c`` object should throw an attribute error
when access is attempted to an attribute that doesn't exist.
A dict of Content-Type related default settings for new
instances of :class:`~pylons.controllers.util.Request`. May
contain the values ``charset`` and ``errors`` and
``decode_param_names``. Overrides the Pylons default values
specified by the ``request_defaults`` dict.
A dict of Content-Type related default settings for new
instances of :class:`~pylons.controllers.util.Response`. May
contain the values ``content_type``, ``charset`` and
``errors``. Overrides the Pylons default values specified by
the ``response_defaults`` dict.
Mapper object used for Routing. Yes, it is possible to add
routes after your application has started running.
defaults = {
'debug': False,
'pylons.package': None,
'pylons.paths': {'root': None,
'controllers': None,
'templates': [],
'static_files': None},
'pylons.db_engines': {},
'pylons.environ_config': dict(session='beaker.session',
'pylons.g': None,
'pylons.h': None,
'pylons.request_options': request_defaults.copy(),
'pylons.response_options': response_defaults.copy(),
'pylons.strict_c': False,
'pylons.c_attach_args': True,
'buffet.template_engines': [],
'buffet.template_options': {},
def __getattr__(self, name):
# Backwards compatibility
if name == 'Config':
class FakeConfig(object):
def __init__(this, *args, **kwargs):
self.load_environment(*args, **kwargs)
def __getattr__(this, name):
return getattr(self, name)
def __setattr__(this, name, value):
setattr(self, name, value)
return FakeConfig
conf_dict = self.current_conf()
# Backwards compat for when the option is now in the dict,
# and access was attempted via attribute
for prefix in ('', 'pylons.', 'buffet.', 'routes.'):
full_name = prefix + name
if full_name in conf_dict:
warnings.warn(pylons.legacy.config_attr_moved % \
(name, full_name), DeprecationWarning, 3)
return conf_dict[full_name]
if name == 'request_defaults':
return request_defaults
elif name == 'response_defaults':
return response_defaults
return getattr(conf_dict, name)
def load_environment(self, tmpl_options=None, map=None, paths=None,
environ_config=None, default_charset=None,
strict_c=False, request_settings=None,
"""Load the environment options
Deprecated functionality for pre-0.9.6 projects.
DeprecationWarning, 3)
conf = copy.deepcopy(PylonsConfig.defaults)
if tmpl_options:
conf['buffet.template_options'] = tmpl_options
if request_settings:
if response_settings:
if environ_config is not None:
conf['pylons.environ_config'] = environ_config
conf[''] = map
conf['pylons.paths'] = paths or {}
conf['pylons.strict_c'] = strict_c
if default_charset:
warnings.warn(pylons.legacy.default_charset_warning % \
dict(klass='Config', charset=default_charset),
DeprecationWarning, 2)
conf['pylons.response_options']['charset'] = default_charset
self['environment_load'] = conf
def add_template_engine(self, engine, root, options=None, alias=None):
"""Add additional template engines for configuration on Pylons
WSGI init.
The name of the template engine
Template root for the engine
Dict of additional options used during engine
initialization, if not provided, default to using the
template_options dict.
Name engine should respond to when actually used. This
allows for multiple configurations of the same engine and
lets you alias the additional ones to other names.
Example of Kid addition:
.. code-block:: python
# In yourproj/
# ...
config.init_app(global_conf, app_conf, package='yourproj')
# Load additional template engines
kidopts = {'kid.assume_encoding':'utf-8',
config.add_template_engine('kid', 'yourproj.kidtemplates',
Example of changing the default template engine:
.. code-block:: python
# In yourproj/
# ...
config.init_app(global_conf, app_conf, package='yourproj')
# Remove existing template engine
old_default = config.template_engines.pop()
# Load additional template engines
kidopts = {'kid.assume_encoding':'utf-8',
config.add_template_engine('kid', 'yourproj.kidtemplates',
# Add old default as additional engine
if not options:
options = self['buffet.template_options']
config = dict(engine=engine, template_root=root,
template_options=options, alias=alias)
log.debug("Adding %s engine with alias %s and %s options", engine,
alias, options)
def init_app(self, global_conf, app_conf, package=None,
template_engine=default_template_engine, paths=None):
"""Initialize configuration for the application
.. note
This *must* be called at least once, as soon as possible
tosetup all the configuration options.
Several options are expected to be set for a Pylons web
application. They will be loaded from the global_config
which has the main Paste options. If ``debug`` is not
enabled as a global config option, the following option
*must* be set:
* error_to - The email address to send the debug error to
The optional config options in this case are:
* smtp_server - The SMTP server to use, defaults to
* error_log - A logfile to write the error to
* error_subject_prefix - The prefix of the error email
* from_address - Whom the error email should be from
Defaults supplied via the [app:main] section from the Paste
config file. ``load_config`` only cares about whether a
'prefix' option is set, if so it will update Routes to
ensure URL's take that into account.
The name of the application package, to be stored in the
.. versionchanged:: 0.9.7
``template_engine`` is no longer required, and can be set
to :data:`None` to avoid loading the default one.
Declare the default template engine to setup. Choices are
kid, genshi, mako (the default), and pylonsmyghty.
log.debug("Initializing configuration, package: '%s'", package)
conf = global_conf.copy()
conf.update(dict(app_conf=app_conf, global_conf=global_conf))
conf.update(self.pop('environment_load', {}))
if paths:
conf['pylons.paths'] = paths
# XXX Legacy: More backwards compatibility locations for the package
# name
conf['pylons.package'] = conf['package'] = \
conf['app_conf']['package'] = package
if 'debug' in conf:
conf['debug'] = asbool(conf['debug'])
if paths and 'root_path' in paths:
warnings.warn(pylons.legacy.root_path, DeprecationWarning, 2)
paths['root'] = paths['root_path']
log.debug("Pushing process configuration")
def set_defaults(self, template_engine):
conf = self.current_conf()
# Load the MIMETypes with its default types
# Ensure all the keys from defaults are present, load them if not
for key, val in copy.deepcopy(PylonsConfig.defaults).iteritems():
conf.setdefault(key, val)
# Setup the prefix to override the routes if necessary.
prefix = conf.get('prefix')
if prefix:
warnings.warn(pylons.legacy.prefix_warning % prefix,
DeprecationWarning, 3)
map = conf.get('')
if map:
map.prefix = prefix
map._created_regs = False
# Load the errorware configuration from the Paste configuration file
# These all have defaults, and emails are only sent if configured and
# if this application is running in production mode
errorware = {}
errorware['debug'] = asbool(conf.get('debug'))
if not errorware['debug']:
errorware['debug'] = False
errorware['error_email'] = conf.get('email_to')
errorware['error_log'] = conf.get('error_log', None)
errorware['smtp_server'] = conf.get('smtp_server',
errorware['error_subject_prefix'] = conf.get(
'error_subject_prefix', 'WebApp Error: ')
errorware['from_address'] = conf.get(
'from_address', conf.get('error_email_from',
errorware['error_message'] = conf.get('error_message',
'An internal server error occurred')
# Standard Pylons configuration directives for Myghty
myghty_defaults = {}
# Raise a complete error for the error middleware to catch
myghty_defaults['raise_error'] = True
myghty_defaults['output_encoding'] = \
myghty_defaults['component_root'] = [{os.path.basename(path): path} \
for path in conf['pylons.paths']['templates']]
# Merge additional globals
myghty_template_options = {}
if 'myghty_data_dir' in conf:
warnings.warn("Old config option found in ini file, replace "
"'myghty_data_dir' option with 'data_dir'",
DeprecationWarning, 3)
myghty_defaults['data_dir'] = conf['myghty_data_dir']
elif 'cache_dir' in conf:
myghty_defaults['data_dir'] = os.path.join(conf['cache_dir'],
# Copy in some defaults
if 'cache_dir' in conf:
os.path.join(conf['cache_dir'], 'sessions'))
os.path.join(conf['cache_dir'], 'cache'))
# Copy Myghty defaults and options into template options
for k, v in myghty_defaults.iteritems():
myghty_template_options['myghty.'+k] = v
# Legacy copy of session and cache settings into conf
if k.startswith('session_') or k.startswith('cache_'):
conf[k] = v
# Copy old session/cache config to new keys for Beaker 0.7+
for key, val in conf.items():
if key.startswith('cache_'):
conf['cache.'+key[6:]] = val
elif key.startswith('session_'):
conf['session.'+key[8:]] = val
# Setup the main template options dict
# Setup several defaults for various template languages
defaults = {}
# Rearrange template options as default for Mako
defaults['mako.directories'] = conf['pylons.paths']['templates']
defaults['mako.filesystem_checks'] = True
defaults['mako.output_encoding'] = \
if 'cache_dir' in conf:
defaults['mako.module_directory'] = \
os.path.join(conf['cache_dir'], 'templates')
# Setup kid defaults
defaults['kid.assume_encoding'] = 'utf-8'
defaults['kid.encoding'] = conf['pylons.response_options']['charset']
# Merge template options into defaults
conf['buffet.template_options'] = defaults
# Prepare our default template engine
if template_engine == 'pylonsmyghty':
self.add_template_engine('pylonsmyghty', None,
elif template_engine == 'mako':
self.add_template_engine('mako', '')
elif template_engine in ['genshi', 'kid']:
conf['pylons.package'] + '.templates')
elif template_engine == 'cheetah':
self.add_template_engine(template_engine, '%s.templates' %
log.debug("Loaded %s template engine as the default template "
"renderer", template_engine)
conf['pylons.cache_dir'] = conf.pop('cache_dir',
# Save our errorware values
conf['pylons.errorware'] = errorware
config = PylonsConfig()
# Push an empty config so all accesses to config at import time have something
# to look at and modify. This config will be merged with the app's when it's
# built in the paste.app_factory entry point.
initial_config = copy.deepcopy(PylonsConfig.defaults)
Jump to Line
Something went wrong with that request. Please try again.