From bbba28212ce0f58096a4043f32442c6e727b74fc Mon Sep 17 00:00:00 2001 From: Mariusz Felisiak Date: Mon, 8 Mar 2021 12:16:20 +0100 Subject: bpo-43353: Document that logging.getLevelName() accepts string representation of logging level. (GH-24693) [bpo-43353]() Automerge-Triggered-By: GH:vsajip --- Lib/logging/__init__.py | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) (limited to 'Lib/logging') diff --git a/Lib/logging/__init__.py b/Lib/logging/__init__.py index 50b7378cd6..411aa53a0b 100644 --- a/Lib/logging/__init__.py +++ b/Lib/logging/__init__.py @@ -118,7 +118,7 @@ _nameToLevel = { def getLevelName(level): """ - Return the textual representation of logging level 'level'. + Return the textual or numeric representation of logging level 'level'. If the level is one of the predefined levels (CRITICAL, ERROR, WARNING, INFO, DEBUG) then you get the corresponding string. If you have @@ -128,7 +128,11 @@ def getLevelName(level): If a numeric value corresponding to one of the defined levels is passed in, the corresponding string representation is returned. - Otherwise, the string "Level %s" % level is returned. + If a string representation of the level is passed in, the corresponding + numeric value is returned. + + If no matching numeric or string value is passed in, the string + 'Level %s' % level is returned. """ # See Issues #22386, #27937 and #29220 for why it's this way result = _levelToName.get(level) -- cgit v1.2.1