Rooba
/
cpython
mirror of https://github.com/python/cpython.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Issue #23536: Clarified scope of fileConfig()'s API.

This commit is contained in:
Vinay Sajip 2015-04-18 13:14:10 +01:00
parent 6a69466f61
commit 2d965c2555
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Doc/library/logging.config.rst
View File

@ -615,6 +615,18 @@ called ``form01`` in the ``[formatters]`` section will have its configuration
specified in a section called ``[formatter_form01]``. The root logger
configuration must be specified in a section called ``[logger_root]``.
.. note::
The :func:`fileConfig` API is older than the :func:`dictConfig` API and does
not provide functionality to cover certain aspects of logging. For example,
you cannot configure :class:`~logging.Filter` objects, which provide for
filtering of messages beyond simple integer levels, using :func:`fileConfig`.
If you need to have instances of :class:`~logging.Filter` in 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]