mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 03:22:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Closes #22436: Merged documentation update from 3.4.

Browse source
This commit is contained in:
Vinay Sajip 2014-09-18 18:02:29 +01:00
commit c58c7d487b
1 changed files with 11 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

13
Doc/library/logging.rst
View file

@ -118,7 +118,9 @@ is the module's name in the Python package namespace.
.. versionchanged:: 3.2 .. versionchanged:: 3.2
The *lvl* parameter now accepts a string representation of the The *lvl* parameter now accepts a string representation of the
level such as 'INFO' as an alternative to the integer constants 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) .. 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 Indicates the effective level for this logger. If a value other than
:const:`NOTSET` has been set using :meth:`setLevel`, it is returned. Otherwise, :const:`NOTSET` has been set using :meth:`setLevel`, it is returned. Otherwise,
the hierarchy is traversed towards the root until a value other than 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) .. method:: Logger.getChild(suffix)
@ -1054,6 +1058,11 @@ functions.
of the defined levels is passed in, the corresponding string representation is of the defined levels is passed in, the corresponding string representation is
returned. Otherwise, the string 'Level %s' % lvl is returned. 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 .. versionchanged:: 3.4
In Python versions earlier than 3.4, this function could also be passed a 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. text level, and would return the corresponding numeric value of the level.