관리-도구

편집 파일: _tracing.py

"""
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,))