oslo.config/doc/source
Chris Dent ea8a0f6a8b Add support for looking in environment for config
An _environment source is added that looks in os.environ for
values.

Using the environment is on by default, but can be shut down
by setting `use_env` to False when __call__ is called.

The enviroment is inspected before any other sources
of config data but the value is used after command line
arguments and before config file options.

This is done by checking both the command line and config
files and then inspecting the location of the result. If
it is command_line, we use it. If not, we use the environment
value (if any). If there's no environment value, the config
file value is used. If checking the command line and config
file results in a KeyError, the environment value is used,
if set.

The names of the environment variables follow the rules
described in oslo_config.sources._environment.

A new exception has been added: ConfigSourceValueError, this
is the superclass of the existing ConfigFileValueError. The
code in _do_get has been updated to only use
ConfigFileValueError when it is in fact a file from whence a
ValueError came.

Documentation has been updated and a rlease note created to
indicate the new functionality.

Change-Id: I3245c40ebdcc96f8e3b2dc0bab3b4aa71d07ad15
2018-10-17 20:49:05 +01:00
..
cli Remove redundant colon in doc 2017-08-29 00:00:41 +08:00
configuration move configuration option list to the configuration guide 2018-06-28 10:55:07 -04:00
contributor rearrange docs based on new standard layout 2017-06-27 17:17:27 -04:00
reference Add support for looking in environment for config 2018-10-17 20:49:05 +01:00
conf.py doc: Specify openstackdocs theme 2017-07-08 23:00:24 +00:00
config-generator.conf Add sphinx extension to build sample config 2015-08-11 10:18:40 -04:00
index.rst import content from the configuration reference guide 2017-06-29 14:31:39 -04:00