Gecko [ www.jobworksschool.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
analyze	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
cmd	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
config	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
distros	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
filters	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
handlers	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
log	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
mergers	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
net	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
reporting	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
sources	[ DIR ]	drwxr-xr-x	2025-11-05 21:54
__init__.py	0 B	-rw-r--r--	2025-08-12 19:11
apport.py	8.3 KB	-rw-r--r--	2025-08-12 19:11
atomic_helper.py	2.79 KB	-rw-r--r--	2025-08-12 19:11
cloud.py	3.71 KB	-rw-r--r--	2025-08-12 19:11
dmi.py	7.81 KB	-rw-r--r--	2025-08-12 19:11
event.py	2 KB	-rw-r--r--	2025-08-12 19:11
features.py	5.63 KB	-rw-r--r--	2025-08-12 21:19
gpg.py	7.99 KB	-rw-r--r--	2025-08-12 19:11
helpers.py	16.16 KB	-rw-r--r--	2025-08-12 19:11
importer.py	2.43 KB	-rw-r--r--	2025-08-12 19:11
lifecycle.py	7.79 KB	-rw-r--r--	2025-08-12 19:11
netinfo.py	24.07 KB	-rw-r--r--	2025-08-12 19:11
performance.py	3.1 KB	-rw-r--r--	2025-08-12 19:11
persistence.py	2.52 KB	-rw-r--r--	2025-08-12 19:11
registry.py	1022 B	-rw-r--r--	2025-08-12 19:11
safeyaml.py	10.11 KB	-rw-r--r--	2025-08-12 19:11
settings.py	2.12 KB	-rw-r--r--	2025-08-12 19:11
signal_handler.py	2.96 KB	-rw-r--r--	2025-08-12 19:11
simpletable.py	1.93 KB	-rw-r--r--	2025-08-12 19:11
socket.py	6.04 KB	-rw-r--r--	2025-08-12 19:11
ssh_util.py	22.44 KB	-rw-r--r--	2025-08-12 19:11
stages.py	41.53 KB	-rw-r--r--	2025-08-12 19:11
subp.py	12.36 KB	-rw-r--r--	2025-08-12 19:11
temp_utils.py	2.94 KB	-rw-r--r--	2025-08-12 19:11
templater.py	7.74 KB	-rw-r--r--	2025-08-12 19:11
type_utils.py	703 B	-rw-r--r--	2025-08-12 19:11
url_helper.py	38.18 KB	-rw-r--r--	2025-08-12 19:11
user_data.py	14.44 KB	-rw-r--r--	2025-08-12 19:11
util.py	90.86 KB	-rw-r--r--	2025-08-12 21:19
version.py	564 B	-rw-r--r--	2025-08-12 21:19
warnings.py	3.76 KB	-rw-r--r--	2025-08-12 19:11

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