Skip to content

logging_interface

appimage_updater.instrumentation.logging_interface

Logging interface for HTTP instrumentation with dependency injection.

ConfigurableHTTPLogger(base_logger, tracking_level='debug', request_level='debug', error_level='debug')

HTTP logger with configurable log levels.

Parameters:

Name Type Description Default
base_logger HTTPLogger

Underlying logger implementation

 required
tracking_level str

Level for start/stop tracking messages

 'debug'
request_level str

Level for individual request messages

 'debug'
error_level str

Level for error messages

 'debug'
Source code in src/appimage_updater/instrumentation/logging_interface.py 
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
def __init__(
    self,
    base_logger: HTTPLogger,
    tracking_level: str = "debug",
    request_level: str = "debug",
    error_level: str = "debug",
):
    """Initialize with configurable log levels.

    Args:
        base_logger: Underlying logger implementation
        tracking_level: Level for start/stop tracking messages
        request_level: Level for individual request messages
        error_level: Level for error messages
    """
    self._base_logger = base_logger
    self._tracking_level = tracking_level
    self._request_level = request_level
    self._error_level = error_level

log_error(message, **kwargs)

Log error message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
103
104
105
def log_error(self, message: str, **kwargs: Any) -> None:
    """Log error message."""
    self._base_logger.log(self._error_level, message, **kwargs)

log_request(message, **kwargs)

Log individual request message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
 99
100
101
def log_request(self, message: str, **kwargs: Any) -> None:
    """Log individual request message."""
    self._base_logger.log(self._request_level, message, **kwargs)

log_tracking_start(message, **kwargs)

Log tracking start message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
91
92
93
def log_tracking_start(self, message: str, **kwargs: Any) -> None:
    """Log tracking start message."""
    self._base_logger.log(self._tracking_level, message, **kwargs)

log_tracking_stop(message, **kwargs)

Log tracking stop message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
95
96
97
def log_tracking_stop(self, message: str, **kwargs: Any) -> None:
    """Log tracking stop message."""
    self._base_logger.log(self._tracking_level, message, **kwargs)

warning(message, **kwargs)

Log warning message (always at warning level).

Source code in src/appimage_updater/instrumentation/logging_interface.py 
107
108
109
def warning(self, message: str, **kwargs: Any) -> None:
    """Log warning message (always at warning level)."""
    self._base_logger.warning(message, **kwargs)

HTTPLogger

Protocol for HTTP logging interface.

debug(message, **kwargs)

Log debug message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
22
23
24
def debug(self, message: str, **kwargs: Any) -> None:
    """Log debug message."""
    ...

error(message, **kwargs)

Log error message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
34
35
36
def error(self, message: str, **kwargs: Any) -> None:
    """Log error message."""
    ...

info(message, **kwargs)

Log info message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
26
27
28
def info(self, message: str, **kwargs: Any) -> None:
    """Log info message."""
    ...

log(level, message, **kwargs)

Log message at specified level.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
18
19
20
def log(self, level: str, message: str, **kwargs: Any) -> None:
    """Log message at specified level."""
    ...

warning(message, **kwargs)

Log warning message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
30
31
32
def warning(self, message: str, **kwargs: Any) -> None:
    """Log warning message."""
    ...

LoguruHTTPLogger(logger_name='appimage_updater.instrumentation.http_tracker')

Loguru-based implementation of HTTPLogger.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
43
44
45
def __init__(self, logger_name: str = "appimage_updater.instrumentation.http_tracker"):
    """Initialize with specific logger name."""
    self._logger = logger.bind(name=logger_name)

debug(message, **kwargs)

Log debug message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
51
52
53
def debug(self, message: str, **kwargs: Any) -> None:
    """Log debug message."""
    self._logger.debug(message, **kwargs)

error(message, **kwargs)

Log error message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
63
64
65
def error(self, message: str, **kwargs: Any) -> None:
    """Log error message."""
    self._logger.error(message, **kwargs)

info(message, **kwargs)

Log info message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
55
56
57
def info(self, message: str, **kwargs: Any) -> None:
    """Log info message."""
    self._logger.debug(message, **kwargs)

log(level, message, **kwargs)

Log message at specified level.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
47
48
49
def log(self, level: str, message: str, **kwargs: Any) -> None:
    """Log message at specified level."""
    self._logger.log(level.upper(), message, **kwargs)

warning(message, **kwargs)

Log warning message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
59
60
61
def warning(self, message: str, **kwargs: Any) -> None:
    """Log warning message."""
    self._logger.warning(message, **kwargs)

TraceHTTPLogger(use_rich=True)

HTTP logger that outputs real-time trace information to console.

Parameters:

Name Type Description Default
use_rich bool

Whether to use Rich console for colored output

 True
Source code in src/appimage_updater/instrumentation/logging_interface.py 
132
133
134
135
136
137
138
139
140
141
def __init__(self, use_rich: bool = True):
    """Initialize trace logger.

    Args:
        use_rich: Whether to use Rich console for colored output
    """
    self.use_rich = use_rich and Console is not None
    self.console: Any = None
    if self.use_rich:
        self.console = Console(stderr=True)

console = None instance-attribute

use_rich = use_rich and Console is not None instance-attribute

log_error(message, **kwargs)

Log error message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
156
157
158
def log_error(self, message: str, **kwargs: Any) -> None:
    """Log error message."""
    self._print_trace(f"{message}", "red")

log_request(message, **kwargs)

Log individual request message with timing.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
151
152
153
154
def log_request(self, message: str, **kwargs: Any) -> None:
    """Log individual request message with timing."""
    # Extract timing info from message if available
    self._print_trace(f"{message}", "green")

log_tracking_start(message, **kwargs)

Log tracking start message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
143
144
145
def log_tracking_start(self, message: str, **kwargs: Any) -> None:
    """Log tracking start message."""
    self._print_trace("HTTP TRACE: Starting request tracking", "blue")

log_tracking_stop(message, **kwargs)

Log tracking stop message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
147
148
149
def log_tracking_stop(self, message: str, **kwargs: Any) -> None:
    """Log tracking stop message."""
    self._print_trace("HTTP TRACE: Stopping request tracking", "blue")

warning(message, **kwargs)

Log warning message.

Source code in src/appimage_updater/instrumentation/logging_interface.py 
160
161
162
def warning(self, message: str, **kwargs: Any) -> None:
    """Log warning message."""
    self._print_trace(f" {message}", "yellow")

create_default_http_logger(verbose=False)

Create default HTTP logger with appropriate verbosity.

Parameters:

Name Type Description Default
verbose bool

If True, use info level for tracking messages

 False

Returns:

Type Description
ConfigurableHTTPLogger

Configured HTTP logger
Source code in src/appimage_updater/instrumentation/logging_interface.py 
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
def create_default_http_logger(verbose: bool = False) -> ConfigurableHTTPLogger:
    """Create default HTTP logger with appropriate verbosity.

    Args:
        verbose: If True, use info level for tracking messages

    Returns:
        Configured HTTP logger
    """
    base_logger = LoguruHTTPLogger()

    if verbose:
        return ConfigurableHTTPLogger(base_logger, tracking_level="info", request_level="debug", error_level="warning")
    else:
        return ConfigurableHTTPLogger(base_logger, tracking_level="debug", request_level="debug", error_level="debug")

create_trace_http_logger(use_rich=True)

Create trace HTTP logger for real-time request monitoring.

Parameters:

Name Type Description Default
use_rich bool

Whether to use Rich console for colored output

 True

Returns:

Type Description
TraceHTTPLogger

Trace HTTP logger
Source code in src/appimage_updater/instrumentation/logging_interface.py 
173
174
175
176
177
178
179
180
181
182
def create_trace_http_logger(use_rich: bool = True) -> TraceHTTPLogger:
    """Create trace HTTP logger for real-time request monitoring.

    Args:
        use_rich: Whether to use Rich console for colored output

    Returns:
        Trace HTTP logger
    """
    return TraceHTTPLogger(use_rich=use_rich)