summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2022-05-23 12:45:44 -0700
committerGitHub <noreply@github.com>2022-05-23 20:45:44 +0100
commit251104f12d0cebb997f26f8ca3dac48202c7456a (patch)
tree8182af7a4ca111e6889d9c5114f5345ab353d959
parentb15b94de091d184e1f1281af190debaf9b92de78 (diff)
downloadcpython-git-251104f12d0cebb997f26f8ca3dac48202c7456a.tar.gz
[3.10] gh-92859: Doc: add info about logging.debug() calling basicConfig() (GH-93063) (GH-93150)
-rw-r--r--Doc/howto/logging.rst9
-rw-r--r--Doc/library/logging.rst8
2 files changed, 13 insertions, 4 deletions
diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst
index fcc6bec768..ff4e1d73a9 100644
--- a/Doc/howto/logging.rst
+++ b/Doc/howto/logging.rst
@@ -178,10 +178,11 @@ following example::
raise ValueError('Invalid log level: %s' % loglevel)
logging.basicConfig(level=numeric_level, ...)
-The call to :func:`basicConfig` should come *before* any calls to :func:`debug`,
-:func:`info` etc. As it's intended as a one-off simple configuration facility,
-only the first call will actually do anything: subsequent calls are effectively
-no-ops.
+The call to :func:`basicConfig` should come *before* any calls to
+:func:`debug`, :func:`info`, etc. Otherwise, those functions will call
+:func:`basicConfig` for you with the default options. As it's intended as a
+one-off simple configuration facility, only the first call will actually do
+anything: subsequent calls are effectively no-ops.
If you run the above script several times, the messages from successive runs
are appended to the file *example.log*. If you want each run to start afresh,
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index b32af94e85..c9b049388e 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -242,6 +242,10 @@ is the module's name in the Python package namespace.
above example). In such circumstances, it is likely that specialized
:class:`Formatter`\ s would be used with particular :class:`Handler`\ s.
+ If no handler is attached to this logger (or any of its ancestors,
+ taking into account the relevant :attr:`Logger.propagate` attributes),
+ the message will be sent to the handler set on :attr:`lastResort`.
+
.. versionchanged:: 3.2
The *stack_info* parameter was added.
@@ -1038,6 +1042,10 @@ functions.
above example). In such circumstances, it is likely that specialized
:class:`Formatter`\ s would be used with particular :class:`Handler`\ s.
+ This function (as well as :func:`info`, :func:`warning`, :func:`error` and
+ :func:`critical`) will call :func:`basicConfig` if the root logger doesn't
+ have any handler attached.
+
.. versionchanged:: 3.2
The *stack_info* parameter was added.