结合所有现有的答案以及一些使用经验,我认为我已经列出了确保完全无缝使用新级别所需做的所有事情的清单。以下步骤假设您正在添加一个名为TRACE
,值为logging.DEBUG - 5 == 5
的新级别:
- 需要调用
logging.addLevelName(logging.DEBUG - 5, 'TRACE')
来注册新级别,使其可以通过名称引用。
- 为了保持一致性,需要将新级别作为属性添加到
logging
本身中:logging.TRACE = logging.DEBUG - 5
。
- 需要在
logging
模块中添加一个名为trace
的方法。它应该像debug
、info
等方法一样工作。
- 需要将名为
trace
的方法添加到当前配置的记录器类中。由于这并不是100%保证是logging.Logger
,因此请改用logging.getLoggerClass()
。
所有步骤都在下面的方法中说明:
def addLoggingLevel(levelName, levelNum, methodName=None):
"""
Comprehensively adds a new logging level to the `logging` module and the
currently configured logging class.
`levelName` becomes an attribute of the `logging` module with the value
`levelNum`. `methodName` becomes a convenience method for both `logging`
itself and the class returned by `logging.getLoggerClass()` (usually just
`logging.Logger`). If `methodName` is not specified, `levelName.lower()` is
used.
To avoid accidental clobberings of existing attributes, this method will
raise an `AttributeError` if the level name is already an attribute of the
`logging` module or if the method name is already present
Example
-------
>>> addLoggingLevel('TRACE', logging.DEBUG - 5)
>>> logging.getLogger(__name__).setLevel("TRACE")
>>> logging.getLogger(__name__).trace('that worked')
>>> logging.trace('so did this')
>>> logging.TRACE
5
"""
if not methodName:
methodName = levelName.lower()
if hasattr(logging, levelName):
raise AttributeError('{} already defined in logging module'.format(levelName))
if hasattr(logging, methodName):
raise AttributeError('{} already defined in logging module'.format(methodName))
if hasattr(logging.getLoggerClass(), methodName):
raise AttributeError('{} already defined in logger class'.format(methodName))
def logForLevel(self, message, *args, **kwargs):
if self.isEnabledFor(levelNum):
self._log(levelNum, message, args, **kwargs)
def logToRoot(message, *args, **kwargs):
logging.log(levelNum, message, *args, **kwargs)
logging.addLevelName(levelNum, levelName)
setattr(logging, levelName, levelNum)
setattr(logging.getLoggerClass(), methodName, logForLevel)
setattr(logging, methodName, logToRoot)
你可以在我维护的实用程序库haggis中找到更详细的实现。函数haggis.logs.add_logging_level
是这个答案的一个更适合生产环境的实现。
logging.DEBUG_LEVEL_NUM = 9
,那么你就可以在导入日志记录器时随时使用该调试级别,你觉得怎么样? - edgarstacklogging.DEBUG_LEVEL_NUM = 9
而不是DEBUG_LEVEL_NUM = 9
。这样,你就可以像使用logging.DEBUG
或logging.INFO
一样使用log_instance.setLevel(logging.DEBUG_LEVEL_NUM)
。 - maQlogging.DEBUGV = DEBUG_LEVELV_NUM
和logging.__all__ += ['DEBUGV']
第二个不是非常重要,但第一个是必要的,如果你有任何动态调整日志级别的代码,并且你想做类似于if verbose: logger.setLevel(logging.DEBUGV)
这样的事情。 - Keith Hanlan