diff options
| author | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2014-09-18 17:02:29 (GMT) |
|---|---|---|
| committer | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2014-09-18 17:02:29 (GMT) |
| commit | c58c7d487b7c5738352d92fab74fa27d951ee574 (patch) | |
| tree | ad17c375f8ecbfbc0d1bd53156ccd949c9f9da86 /Doc/library/logging.rst | |
| parent | 2f2920a17f1b51f9536e5d4c8a9b557558c4a07a (diff) | |
| parent | 2f1cd8a7fcda6080888553b3c0f9ac34b1caad37 (diff) | |
| download | cpython-c58c7d487b7c5738352d92fab74fa27d951ee574.zip cpython-c58c7d487b7c5738352d92fab74fa27d951ee574.tar.gz cpython-c58c7d487b7c5738352d92fab74fa27d951ee574.tar.bz2 | |
Closes #22436: Merged documentation update from 3.4.
Diffstat (limited to 'Doc/library/logging.rst')
| -rw-r--r-- | Doc/library/logging.rst | 13 |
1 files changed, 11 insertions, 2 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index d0e2c27..7915c27 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -118,7 +118,9 @@ is the module's name in the Python package namespace. .. versionchanged:: 3.2 The *lvl* parameter now accepts a string representation of the level such as 'INFO' as an alternative to the integer constants - such as :const:`INFO`. + such as :const:`INFO`. Note, however, that levels are internally stored + as integers, and methods such as e.g. :meth:`getEffectiveLevel` and + :meth:`isEnabledFor` will return/expect to be passed integers. .. method:: Logger.isEnabledFor(lvl) @@ -134,7 +136,9 @@ is the module's name in the Python package namespace. Indicates the effective level for this logger. If a value other than :const:`NOTSET` has been set using :meth:`setLevel`, it is returned. Otherwise, the hierarchy is traversed towards the root until a value other than - :const:`NOTSET` is found, and that value is returned. + :const:`NOTSET` is found, and that value is returned. The value returned is + an integer, typically one of :const:`logging.DEBUG`, :const:`logging.INFO` + etc. .. method:: Logger.getChild(suffix) @@ -1054,6 +1058,11 @@ functions. of the defined levels is passed in, the corresponding string representation is returned. Otherwise, the string 'Level %s' % lvl is returned. + .. note:: Levels are internally integers (as they need to be compared in the + logging logic). This function is used to convert between an integer level + and the level name displayed in the formatted log output by means of the + ``%(levelname)s`` format specifier (see :ref:`logrecord-attributes`). + .. versionchanged:: 3.4 In Python versions earlier than 3.4, this function could also be passed a text level, and would return the corresponding numeric value of the level. |