Minor changes, additions and clarifications.
This commit is contained in:
parent
b6219b9be0
commit
7c738150a2
30
pep-0391.txt
30
pep-0391.txt
|
@ -305,9 +305,9 @@ specify::
|
|||
|
||||
custom:
|
||||
(): my.package.MyHandler
|
||||
alternate: int://handlers.file
|
||||
alternate: cfg://handlers.file
|
||||
|
||||
The literal string ``'int://handlers.file'`` will be resolved in an
|
||||
The literal string ``'cfg://handlers.file'`` will be resolved in an
|
||||
analogous way to the strings with the ``ext://`` prefix, but looking
|
||||
in the configuration itself rather than the import namespace. The
|
||||
mechanism will allow access by dot or by index, in a similar way to
|
||||
|
@ -323,29 +323,29 @@ that provided by ``str.format``. Thus, given the following snippet::
|
|||
- dev_team@domain.tld
|
||||
subject: Houston, we have a problem.
|
||||
|
||||
in the configuration, the string ``'int://handlers'`` would resolve to
|
||||
the dict with key ``handlers``, the string ``'int://handlers.email``
|
||||
in the configuration, the string ``'cfg://handlers'`` would resolve to
|
||||
the dict with key ``handlers``, the string ``'cfg://handlers.email``
|
||||
would resolve to the dict with key ``email`` in the ``handlers`` dict,
|
||||
and so on. The string ``'int://handlers.email.toaddrs[1]`` would
|
||||
and so on. The string ``'cfg://handlers.email.toaddrs[1]`` would
|
||||
resolve to ``'dev_team.domain.tld'`` and the string
|
||||
``'int://handlers.email.toaddrs[0]'`` would resolve to the value
|
||||
``'cfg://handlers.email.toaddrs[0]'`` would resolve to the value
|
||||
``'support_team@domain.tld'``. The ``subject`` value could be accessed
|
||||
using either ``'int://handlers.email.subject'`` or, equivalently,
|
||||
``'int://handlers.email[subject]'``. The latter form only needs to be
|
||||
using either ``'cfg://handlers.email.subject'`` or, equivalently,
|
||||
``'cfg://handlers.email[subject]'``. The latter form only needs to be
|
||||
used if the key contains spaces or non-alphanumeric characters. If an
|
||||
index value consists only of decimal digits, access will be attempted
|
||||
using the corresponding integer value, falling back to the string
|
||||
value if needed.
|
||||
|
||||
Given a string ``int://handlers.myhandler.mykey.123``, this will
|
||||
Given a string ``cfg://handlers.myhandler.mykey.123``, this will
|
||||
resolve to ``config_dict['handlers']['myhandler']['mykey']['123']``.
|
||||
If the string is specified as ``int://handlers.myhandler.mykey[123]``,
|
||||
If the string is specified as ``cfg://handlers.myhandler.mykey[123]``,
|
||||
the system will attempt to retrieve the value from
|
||||
``config_dict['handlers']['myhandler']['mykey'][123]``, ad fall back
|
||||
``config_dict['handlers']['myhandler']['mykey'][123]``, and fall back
|
||||
to ``config_dict['handlers']['myhandler']['mykey']['123']`` if that
|
||||
fails.
|
||||
|
||||
Note: the ``ext`` and ``int`` prefixes are provisional. If better
|
||||
Note: the ``ext`` and ``cfg`` prefixes are provisional. If better
|
||||
alternatives are suggested during the PEP review process, they will be
|
||||
used.
|
||||
|
||||
|
@ -484,6 +484,10 @@ determine how to instantiate.
|
|||
If the specified value is ``True``, the configuration is processed
|
||||
as described in the section on `Incremental Configuration`_, below.
|
||||
|
||||
* `disable_existing_loggers` - whether any existing loggers are to be
|
||||
disabled. This setting mirrors the parameter of the same name in
|
||||
``fileConfig()``. If absent, this parameter defaults to ``True``.
|
||||
This value is ignored if `incremental` is ``True``.
|
||||
|
||||
A Working Example
|
||||
-----------------
|
||||
|
@ -567,7 +571,7 @@ settings in the ``handlers`` entries, and the ``level`` and
|
|||
It's certainly possible to provide incremental configuration by other
|
||||
means, for example making ``dictConfig()`` take an ``incremental``
|
||||
keyword argument which defaults to ``False``. The reason for
|
||||
suggesting that a flag in the configuration dict be used is that it
|
||||
suggesting that a value in the configuration dict be used is that it
|
||||
allows for configurations to be sent over the wire as pickled dicts
|
||||
to a socket listener. Thus, the logging verbosity of a long-running
|
||||
application can be altered over time with no need to stop and
|
||||
|
|
Loading…
Reference in New Issue