3. Settings Config File

This is a list of available settings that can be modified to customize the behavior of your application.

3.1. Items

settings.APP_NAME
The application name. The default is kay_main.
settings.DEFAULT_TIMEZONE
The default local timezone in string, e.g: ‘Asia/Tokyo’. The default is Asia/Tokyo. If it’s not specified Kay automatically set UTC. You can get the valid TimeZone list by reffering to kay/lib/pytz/all_timezone.
settings.DEBUG

This attribute has different effect on local dev server and appengine server.

  • Local environment:

    If DEBUG is set to True, werkzeug’s debugger will come up on any uncaught exception. Otherwise, it just displays 500 error, and tracebacks will be printed on console.

  • Server environment:

    If DEBUG is set to True, it displays tracebacks on your browser on any uncaught exception. Otherwise, it displays a simple error message to end users, and tracebacks will be sent to administrators by email.

settings.SECRET_KEY
The seed to generate a hash value. The default is ReplaceItWithSecretString. Please be sure to rewrite this.
settings.SESSION_PREFIX
The prefix of session name. The default is gaesess:.
settings.COOKIE_AGE
The cookie’s age. The default is 1209600 seconds (2 weeks).
settings.COOKIE_NAME
The cookie’s name. The default is KAY_SESSION.
settings.COOKIE_SECURE
If set to True, the cookie will only be sent over secure connections. The default is False.
settings.SESSION_MEMCACHE_AGE
The session information’s age. The default is 3600 seconds (1 hour).
settings.SESSION_STORE
Choose an implementation for storing a session. A valid value is one of ‘kay.sessions.sessionstore.GAESessionStore’ or ‘kay.sessions.sessionstore.SecureCookieSessionStore’.
The age of a cookie for determining which language to use. The default value is the same as COOKIE_AGE above.

The cookie’s name for the language. The default is hl. If i18n is enabled, Kay will display pages in the language specified with this cookie. Otherwise Kay identifies the language from Accept-Language setting of the browser.

See also

I18n mechanism

FLASH_COOKIE_NAME:
The name of a cookie for storing flash message. The default is KAY_FLASH.
settings.CACHE_MIDDLEWARE_SECONDS
Specify how long to remain caches of HTML responses that views returned. The default is 3600 (1 hour).
settings.CACHE_MIDDLEWARE_NAMESPACE
The namespace of HTML response cache. The default is CACHE_MIDDLEWARE.
settings.CACHE_MIDDLEWARE_ANONYMOUS_ONLY
If set to True, HTML response cache will remain only while user login. The default is True.
settings.FORMS_USE_XHTML
If set to True, kay.utils.forms renders forms in an xhtml comliant manner. The default is False.
settings.ROOT_URL_MODULE
You can have another URL settings file other than urls.py of each application. Specify the URL file’s module name here. The default is urls.
settings.MEDIA_URL
The path to media files. The defautl is /media.
settings.INTERNAL_MEDIA_URL
The path to media files directory that bundle applications (e.g. kay.auto ) use. The default is /_media.
settings.ADMINS

OBSOLETE

Specify the administrator’s username and email address in this tuple. If any exception occurs on the server, Kay send the traceback to this email address. This function works when you disable debugging(DEBUG=False).

(setting example)

ADMINS = (
  ('John', 'john@example.com'),
  ('Mary', 'mary@example.com')
)
settings.NOTIFY_ERRORS_TO_GAE_ADMINS
If this attribute is set to True (True by default), and when any exception occurs on the server, Kay send the traceback to administrators of the application. This feature works only when you disable debugging(DEBUG=False). You need to configure sender e-mail address of this mail by setting DEFAULT_MAIL_FROM.
settings.TEMPLATE_DIRS
Allows you to specify the directory where Kay will look for your templates. This is a list of relative paths from your project root to your template directories.
settings.USE_I18N

If set to True, i18n works. The default is True.

See also

I18n mechanism

settings.DEFAULT_LANG
TODO
settings.INSTALLED_APPS
This tupple must contain application names you want to activate. Default value is an empty tupple.
settings.APP_MOUNT_POINTS

Specify the URL path to access each application in this dictionary. The key is the applicaion and the value is the URL path. If not specified, the URL path will be set /application's module name by default.

APP_MOUNT_POINTS = {
  'bbs': '/',
  'categories': '/c',
}
settings.CONTEXT_PROCESSORS

Specify the path of context processors in this tuple. If you add context proccssors, you can add context variables which the jinja2 template engine use in its rendering process. The default is an empty tuple.

Here are examples:

CONTEXT_PROCESSORS = (
  'kay.context_processors.request',
  'kay.context_processors.url_functions',
  'kay.context_processors.media_url',
)
settings.JINJA2_FILTERS
A dictionary of filter name to callable filters that are automatically loaded into the Jinja2 environment.
settings.JINJA2_ENVIRONMENT_KWARGS

The keyword arguments passed to Jinja2 contructor. The default is following.

JINJA2_ENVIRONMENT_KWARGS = {
  'autoescape': True,
}
settings.JINJA2_EXTENSIONS
A list of Jinja2 extension classes. These are automatically imported and loaded into the Jinja2 environment.
settings.SUBMOUNT_APPS
If you’d like to run applications with entirely-differnt settings, you can set them here. The default is an empty tuple.
settings.MIDDLEWARE_CLASSES

Specify additional middlewares to this tuple. The default is an empty tuple. Here are examples:

MIDDLEWARE_CLASSES = (
  'kay.session.middleware.SessionMiddleware',
  'kay.auth.middleware.AuthenticationMiddleware',
)
settings.AUTH_USER_BACKEND

The backend class for user authentication. The default is kay.auth.backends.googleaccount.GoogleBackend.

settings.AUTH_USER_MODEL

The model class for saving the user data authenticated by the backend. When you use the user class inherites from GoogleUser for authentication, you have to set it here. The defautl is kay.auth.models.GoogleUser.

settings.USE_DB_HOOK
If set to True, DB hook is enabled. DB hook is similar to Django’s signal. You can run some processes when datastore is accessed. If you are unfamiliar with DB hook, you should set this to False. The default is False.
settings.DEFAULT_MAIL_FROM
The e-mail address configured here is used for FROM address of e-mails sent by Kay.

Table Of Contents

Previous topic

2. Debugging

Next topic

4. Management script

This Page