Gecko [ actualbuzz.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
analyze	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
cmd	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
config	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
distros	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
filters	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
handlers	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
log	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
mergers	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
net	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
reporting	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
sources	[ DIR ]	drwxr-xr-x	2026-02-03 14:59
__init__.py	0 B	-rw-r--r--	2024-11-25 16:09
apport.py	8.27 KB	-rw-r--r--	2024-11-25 16:09
atomic_helper.py	2.79 KB	-rw-r--r--	2024-11-25 16:09
cloud.py	3.71 KB	-rw-r--r--	2024-11-25 16:09
dmi.py	7.86 KB	-rw-r--r--	2024-11-25 16:09
event.py	2 KB	-rw-r--r--	2024-11-25 16:09
features.py	4.87 KB	-rw-r--r--	2026-02-02 09:03
gpg.py	7.99 KB	-rw-r--r--	2024-11-25 16:09
helpers.py	16.16 KB	-rw-r--r--	2024-11-25 16:09
importer.py	2.43 KB	-rw-r--r--	2024-11-25 16:09
lifecycle.py	7.78 KB	-rw-r--r--	2024-11-25 16:09
netinfo.py	24.02 KB	-rw-r--r--	2024-11-25 16:09
performance.py	3.1 KB	-rw-r--r--	2024-11-25 16:09
persistence.py	2.52 KB	-rw-r--r--	2024-11-25 16:09
registry.py	1022 B	-rw-r--r--	2024-11-25 16:09
safeyaml.py	10.11 KB	-rw-r--r--	2024-11-25 16:09
settings.py	2.15 KB	-rw-r--r--	2026-02-02 09:03
signal_handler.py	1.75 KB	-rw-r--r--	2024-11-25 16:09
simpletable.py	1.93 KB	-rw-r--r--	2024-11-25 16:09
socket.py	5.93 KB	-rw-r--r--	2024-11-25 16:09
ssh_util.py	22.22 KB	-rw-r--r--	2026-02-02 09:03
stages.py	41.53 KB	-rw-r--r--	2024-11-25 16:09
subp.py	12.36 KB	-rw-r--r--	2024-11-25 16:09
temp_utils.py	2.94 KB	-rw-r--r--	2024-11-25 16:09
templater.py	7.8 KB	-rw-r--r--	2024-11-25 16:09
type_utils.py	703 B	-rw-r--r--	2024-11-25 16:09
url_helper.py	34.7 KB	-rw-r--r--	2024-11-25 16:09
user_data.py	14.44 KB	-rw-r--r--	2024-11-25 16:09
util.py	91.22 KB	-rw-r--r--	2024-11-25 16:09
version.py	564 B	-rw-r--r--	2026-02-02 09:03
warnings.py	3.76 KB	-rw-r--r--	2024-11-25 16:09

Rename

import functools
import logging
import time

LOG = logging.getLogger(__name__)

class Timed:
    """
    A context manager which measures and optionally logs context run time.

:param msg: A message that describes the thing that is being measured
    :param threshold: Threshold, in seconds. When the context exceeds this
        threshold, a log will be made.
    :param log_mode: Control whether to log. Defaults to "threshold". Possible
        values include:
        "always" - Always log 'msg', even when 'threshold' is not reached.
        "threshold" - Log when context time exceeds 'threshold'.
        "skip" - Do not log. Context time and message are stored in the
            'output' and 'delta' attributes, respectively. Used to manually
            coalesce with other logs at the call site.

usage:

this call:
        ```
        with Timed("Configuring the network"):
            run_configure()
        ```

might produce this log:
        ```
            Configuring the network took 0.100 seconds
        ```
    """

def __init__(
        self,
        msg: str,
        *,
        threshold: float = 0.01,
        log_mode: str = "threshold",
    ):
        self.msg = msg
        self.threshold = threshold
        self.log_mode = log_mode
        self.output = ""
        self.start = 0.0
        self.delta = 0.0

def __enter__(self):
        self.start = time.monotonic()
        return self

def __exit__(self, exc_type, exc_val, exc_tb):
        self.delta = time.monotonic() - self.start
        suffix = f"took {self.delta:.3f} seconds"
        if "always" == self.log_mode:
            LOG.debug("%s %s", self.msg, suffix)
        elif "skip" == self.log_mode:
            return
        elif "threshold" == self.log_mode:
            if self.delta > self.threshold:
                LOG.debug("%s %s", self.msg, suffix)
                self.output = f"{self.msg} {suffix}"
        else:
            raise ValueError(
                f"Invalid Timed log_mode value: '{self.log_mode}'."
            )

def timed(msg: str, *, threshold: float = 0.01, log_mode: str = "threshold"):
    """
    A decorator which measures and optionally logs context run time.

usage:

this call:
        ```
        @timed("Configuring the network")
        def run_configure():
            ...
        ```

might produce this log:
        ```
            Configuring the network took 0.100 seconds
        ```
    """

def wrapper(func):
        @functools.wraps(func)
        def decorator(*args, **kwargs):
            with Timed(msg, threshold=threshold, log_mode=log_mode):
                return func(*args, **kwargs)

return decorator

return wrapper