<p>结合所有现有的答案和大量的使用经验,我想我已经列出了所有需要做的事情,以确保完全无缝地使用新的级别。以下步骤假设您正在添加值为<code>logging.DEBUG - 5 == 5</code>的新级别<code>TRACE</code>:</p>
<ol>
<li><code>logging.addLevelName(logging.DEBUG - 5, 'TRACE')</code>需要调用才能在内部注册新级别,以便可以按名称引用它。</li>
<li>新的级别需要作为属性添加到<code>logging</code>本身以保持一致性:<code>logging.TRACE = logging.DEBUG - 5</code>。</li>
<li>需要将名为<code>trace</code>的方法添加到<code>logging</code>模块中。它的行为应该像<code>debug</code>,<code>info</code>等</li>
<li>需要将名为<code>trace</code>的方法添加到当前配置的记录器类中。由于不能百分之百保证是<code>logging.Logger</code>,请改用<code>logging.getLoggerClass()</code>。</li>
</ol>
<p>以下方法说明了所有步骤:</p>
<pre><code>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))
# This method was inspired by the answers to Stack Overflow post
# http://stackoverflow.com/q/2183233/2988730, especially
# http://stackoverflow.com/a/13638084/2988730
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)
</code></pre>