Viewing file:  _util.py (1.3 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
# -*- test-case-name: twisted.logger.test.test_util -*-
# Copyright (c) Twisted Matrix Laboratories.
# See LICENSE for details.
"""
Logging utilities.
"""
def formatTrace(trace):
"""
Format a trace (that is, the contents of the C{log_trace} key of a log
event) as a visual indication of the message's propagation through various
observers.
@param trace: the contents of the C{log_trace} key from an event.
@type trace: object
@return: A multi-line string with indentation and arrows indicating the
flow of the message through various observers.
@rtype: L{unicode}
"""
def formatWithName(obj):
if hasattr(obj, "name"):
return u"{0} ({1})".format(obj, obj.name)
else:
return u"{0}".format(obj)
result = []
lineage = []
for parent, child in trace:
if not lineage or lineage[-1] is not parent:
if parent in lineage:
while lineage[-1] is not parent:
lineage.pop()
else:
if not lineage:
result.append(u"{0}\n".format(formatWithName(parent)))
lineage.append(parent)
result.append(u" " * len(lineage))
result.append(u"-> {0}\n".format(formatWithName(child)))
return u"".join(result)
|