The application configuration file

Using the configuration file

The serve administrative command needs a proper configuration file to launch an application.

You can directly give the configuration file to the serve command, as:

<NAGARE_HOME>/bin/nagare-admin serve /path/to/the/config.cfg

Or, if the application was registered to the framework (as described in Entry points), then you can launch it with:

<NAGARE_HOME>/bin/nagare-admin serve <application>

In this case, the framework reads the configuration file named <application>.cfg in the directory <application>*/conf under <NAGARE_HOME>/lib/python2.7/site-packages.

Note

If an application is launched in debug mode, changes in the configuration file is immediatly reflected. Else, you need to stop then re-launch the application.

Structure

For the boolean parameters, a value of true, yes, on or 1 means True and a value of false, no, off or 0 mean False.

You can use the $here variable which contains the path to the directory where the configuration file is located.

Comments, starting with the # character can be added to a configuration file.

[application] section

Name Mandatory Default value Description
path Yes No default value Reference to the root component factory of the application (see Object references)
name Yes No default value /name will be the URL of the application
static No static directory Filesystem path to the static contents of the application. By default, it’s the static directory under the application installation directory.
always_html No yes If this parameter is false, the framework will send XHTML to the browsers that accept XHTML, else HTML. If this parameter is true, HTML is always generated
debug No no Display the web debug page when an exception occurs. The nagare[debug] extra must be installed.

[database] section

Name Mandatory Default value Description
activated No off If not activated, the framework will not read the following parameters
uri Yes No default value URI or connection string to the database, as described in the SQLAlchemy engine configuration
metadata Yes No default value Reference to the SQLAlchemy metadata object (see Object references)
populate No No default value Reference to an optional function, called after the table creation to populate them with some initial data (see Object references)
debug No off Display the generated SQL requests

All other parameters, if present, are passed as keywords to the SQLALchemy create_engine() call (see http://www.sqlalchemy.org/docs/core/engines.html#engine-creation-api)

If an application needs to work with several database, several subsections can be embedded into the main [database] section:

[database]

[[database1]]      # The name of a subsection is irrelevant but must be unique
activated = on
uri = ...
metadata = ...

[[database2]]
activated = on
uri = ...
metadata = ...