57 lines
1.7 KiB
ReStructuredText
57 lines
1.7 KiB
ReStructuredText
|
|
Config Object
|
|
=============
|
|
|
|
The app has a global :term:`config object` to track its settings.
|
|
This object is an instance of :class:`~wuttjamaican.conf.WuttaConfig`
|
|
and is usually available as e.g. ``self.config`` within code.
|
|
|
|
|
|
Creating the Config Object
|
|
--------------------------
|
|
|
|
All apps create the config object by calling
|
|
:func:`~wuttjamaican.conf.make_config()` during startup. The desired
|
|
config files may be specified directly via call params, or indirectly
|
|
via environment variables. (See also :doc:`files`.)
|
|
|
|
In some cases, notably the :term:`command` line interface, there is
|
|
already code in place to handle the ``make_config()`` call, and you
|
|
must specify the config files in another way - command line parameters
|
|
in this case.
|
|
|
|
One-off scripts should create the config object before doing anything
|
|
else. To be safe this should happen before other modules are
|
|
imported::
|
|
|
|
from wuttjamaican.conf import make_config
|
|
|
|
config = make_config()
|
|
|
|
from otherlib import foo
|
|
|
|
foo(config)
|
|
|
|
|
|
Creating the App Handler
|
|
------------------------
|
|
|
|
The config object is also responsible for creating the :term:`app handler`.
|
|
|
|
Whereas the process of creating the config object is "stable" and
|
|
"always" produces an object of the same class, the app handler is more
|
|
likely to vary. So while there is a default
|
|
:class:`~wuttjamaican.app.AppHandler` provided, it is expected that
|
|
some apps will want to override that.
|
|
|
|
The relationship between config object and app handler may be thought
|
|
of as "one-to-one" since each app will have a global config object as
|
|
well as a global app handler. But the config object does come first,
|
|
to solve the "chicken-vs-egg" problem::
|
|
|
|
from wuttjamaican.conf import make_config
|
|
|
|
config = make_config()
|
|
|
|
app = config.get_app()
|