REDROOM

Edit File Size: 4.42 KB

//lib/python3/dist-packages/twisted/logger/_stdlib.py

Text Base64

# -*- test-case-name: twisted.logger.test.test_stdlib -*-
# Copyright (c) Twisted Matrix Laboratories.
# See LICENSE for details.

"""
Integration with Python standard library logging.
"""

import logging as stdlibLogging
from typing import Mapping, Tuple

from zope.interface import implementer

from constantly import NamedConstant

from twisted.python.compat import currentframe
from ._format import formatEvent
from ._interfaces import ILogObserver, LogEvent
from ._levels import LogLevel

# Mappings to Python's logging module
toStdlibLogLevelMapping: Mapping[NamedConstant, int] = {
    LogLevel.debug: stdlibLogging.DEBUG,
    LogLevel.info: stdlibLogging.INFO,
    LogLevel.warn: stdlibLogging.WARNING,
    LogLevel.error: stdlibLogging.ERROR,
    LogLevel.critical: stdlibLogging.CRITICAL,
}

def _reverseLogLevelMapping() -> Mapping[int, NamedConstant]:
    """
    Reverse the above mapping, adding both the numerical keys used above and
    the corresponding string keys also used by python logging.
    @return: the reversed mapping
    """
    mapping = {}
    for logLevel, pyLogLevel in toStdlibLogLevelMapping.items():
        mapping[pyLogLevel] = logLevel
        mapping[stdlibLogging.getLevelName(pyLogLevel)] = logLevel
    return mapping

fromStdlibLogLevelMapping = _reverseLogLevelMapping()

@implementer(ILogObserver)
class STDLibLogObserver:
    """
    Log observer that writes to the python standard library's C{logging}
    module.

@note: Warning: specific logging configurations (example: network) can lead
        to this observer blocking.  Nothing is done here to prevent that, so be
        sure to not to configure the standard library logging module to block
        when used in conjunction with this module: code within Twisted, such as
        twisted.web, assumes that logging does not block.

@cvar defaultStackDepth: This is the default number of frames that it takes
        to get from L{STDLibLogObserver} through the logging module, plus one;
        in other words, the number of frames if you were to call a
        L{STDLibLogObserver} directly.  This is useful to use as an offset for
        the C{stackDepth} parameter to C{__init__}, to add frames for other
        publishers.
    """

defaultStackDepth = 4

def __init__(
        self, name: str = "twisted", stackDepth: int = defaultStackDepth
    ) -> None:
        """
        @param name: logger identifier.
        @param stackDepth: The depth of the stack to investigate for caller
            metadata.
        """
        self.logger = stdlibLogging.getLogger(name)
        self.logger.findCaller = self._findCaller  # type: ignore[assignment]
        self.stackDepth = stackDepth

def _findCaller(
        self, stackInfo: bool = False, stackLevel: int = 1
    ) -> Tuple[str, int, str, None]:
        """
        Based on the stack depth passed to this L{STDLibLogObserver}, identify
        the calling function.

@param stackInfo: Whether or not to construct stack information.
            (Currently ignored.)
        @param stackLevel: The number of stack frames to skip when determining
            the caller (currently ignored; use stackDepth on the instance).

@return: Depending on Python version, either a 3-tuple of (filename,
            lineno, name) or a 4-tuple of that plus stack information.
        """
        f = currentframe(self.stackDepth)
        co = f.f_code
        extra = (None,)
        return (co.co_filename, f.f_lineno, co.co_name) + extra

def __call__(self, event: LogEvent) -> None:
        """
        Format an event and bridge it to Python logging.
        """
        level = event.get("log_level", LogLevel.info)
        failure = event.get("log_failure")
        if failure is None:
            excInfo = None
        else:
            excInfo = (failure.type, failure.value, failure.getTracebackObject())
        stdlibLevel = toStdlibLogLevelMapping.get(level, stdlibLogging.INFO)
        self.logger.log(stdlibLevel, StringifiableFromEvent(event), exc_info=excInfo)

class StringifiableFromEvent:
    """
    An object that implements C{__str__()} in order to defer the work of
    formatting until it's converted into a C{str}.
    """

def __init__(self, event: LogEvent) -> None:
        """
        @param event: An event.
        """
        self.event = event

def __str__(self) -> str:
        return formatEvent(self.event)

def __bytes__(self) -> bytes:
        return str(self).encode("utf-8")

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
test DIR	-	drwxr-xr-x	2026-01-08 12:56:22	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2026-01-08 12:56:23	Edit Download recursive recursive
_buffer.py	1.49 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_capture.py	624 B	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_file.py	2.28 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_filter.py	6.71 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_flatten.py	4.88 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_format.py	13.16 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_global.py	8.43 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_interfaces.py	2.29 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_io.py	4.44 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_json.py	8.21 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_legacy.py	5.12 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_levels.py	2.89 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_logger.py	9.75 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_observer.py	3.17 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_stdlib.py	4.42 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
_util.py	1.34 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive
__init__.py	3.29 KB	lrw-r--r--	2024-08-27 10:30:39	Edit Download recursive recursive

Directory Contents