72 lines
2 KiB
Python
72 lines
2 KiB
Python
"""
|
|
Tracing utils
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
from typing import Callable
|
|
from typing import Sequence
|
|
from typing import Tuple
|
|
|
|
|
|
_Writer = Callable[[str], None]
|
|
_Processor = Callable[[Tuple[str, ...], Tuple[Any, ...]], None]
|
|
|
|
|
|
class TagTracer:
|
|
def __init__(self) -> None:
|
|
self._tags2proc: dict[tuple[str, ...], _Processor] = {}
|
|
self._writer: _Writer | None = None
|
|
self.indent = 0
|
|
|
|
def get(self, name: str) -> TagTracerSub:
|
|
return TagTracerSub(self, (name,))
|
|
|
|
def _format_message(self, tags: Sequence[str], args: Sequence[object]) -> str:
|
|
if isinstance(args[-1], dict):
|
|
extra = args[-1]
|
|
args = args[:-1]
|
|
else:
|
|
extra = {}
|
|
|
|
content = " ".join(map(str, args))
|
|
indent = " " * self.indent
|
|
|
|
lines = ["{}{} [{}]\n".format(indent, content, ":".join(tags))]
|
|
|
|
for name, value in extra.items():
|
|
lines.append(f"{indent} {name}: {value}\n")
|
|
|
|
return "".join(lines)
|
|
|
|
def _processmessage(self, tags: tuple[str, ...], args: tuple[object, ...]) -> None:
|
|
if self._writer is not None and args:
|
|
self._writer(self._format_message(tags, args))
|
|
try:
|
|
processor = self._tags2proc[tags]
|
|
except KeyError:
|
|
pass
|
|
else:
|
|
processor(tags, args)
|
|
|
|
def setwriter(self, writer: _Writer) -> None:
|
|
self._writer = writer
|
|
|
|
def setprocessor(self, tags: str | tuple[str, ...], processor: _Processor) -> None:
|
|
if isinstance(tags, str):
|
|
tags = tuple(tags.split(":"))
|
|
else:
|
|
assert isinstance(tags, tuple)
|
|
self._tags2proc[tags] = processor
|
|
|
|
|
|
class TagTracerSub:
|
|
def __init__(self, root: TagTracer, tags: tuple[str, ...]) -> None:
|
|
self.root = root
|
|
self.tags = tags
|
|
|
|
def __call__(self, *args: object) -> None:
|
|
self.root._processmessage(self.tags, args)
|
|
|
|
def get(self, name: str) -> TagTracerSub:
|
|
return self.__class__(self.root, self.tags + (name,))
|