cpython: df28044b7e14 (original) (raw)
Mercurial > cpython
changeset 95705:df28044b7e14 2.7
Issue #23536: Clarified scope of fileConfig()'s API. [#23536]
| Vinay Sajip <vinay_sajip@yahoo.co.uk> | |
|---|---|
| date | Sat, 18 Apr 2015 13:05:19 +0100 |
| parents | 867c509c8c5e |
| children | d70995cf44b3 |
| files | Doc/library/logging.config.rst |
| diffstat | 1 files changed, 12 insertions(+), 0 deletions(-)[+] [-] Doc/library/logging.config.rst 12 |
line wrap: on
line diff
--- a/Doc/library/logging.config.rst
+++ b/Doc/library/logging.config.rst
@@ -580,6 +580,18 @@ called form01 in the [formatters]`[](#l1.3) specified in a section called [formatter_form01]. The root logger[](#l1.4) configuration must be specified in a section called [logger_root]``.
+.. note::
+
- The :func:
fileConfigAPI is older than the :func:dictConfigAPI and does - not provide functionality to cover certain aspects of logging. For example,
- you cannot configure :class:
~logging.Filterobjects, which provide for - filtering of messages beyond simple integer levels, using :func:
fileConfig. - If you need to have instances of :class:
~logging.Filterin your logging - configuration, you will need to use :func:
dictConfig. Note that future - enhancements to configuration functionality will be added to
- :func:
dictConfig, so it's worth considering transitioning to this newer - API when it's convenient to do so. +
Examples of these sections in the file are given below. :: [loggers]