bluer-options 5.166.1__tar.gz → 5.170.1__tar.gz

{bluer_options-5.166.1/bluer_options.egg-info → bluer_options-5.170.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_options
-Version: 5.166.1
+Version: 5.170.1
 Summary: 🌀 Options for Bash.
 Home-page: https://github.com/kamangir/bluer-options
 Author: Arash Abadpour (Kamangir)

{bluer_options-5.166.1 → bluer_options-5.170.1}/bluer_options/__init__.py

@@ -6,7 +6,7 @@ ICON = "🌀"
 
 DESCRIPTION = f"{ICON} Options for Bash."
 
-VERSION = "5.166.1"
+VERSION = "5.170.1"
 
 REPO_NAME = "bluer-options"
 

{bluer_options-5.166.1 → bluer_options-5.170.1}/bluer_options/string/functions.py

@@ -221,7 +221,7 @@ def pretty_shape_of_matrix(
 
 
 def pretty_duration(
-    duration: Union[None, int],
+    duration: Union[None, float],
     element_format: str = "{}{}",
     include_ms: bool = False,
     largest: bool = False,

bluer_options-5.170.1/bluer_options/timing/__init__.py

@@ -0,0 +1,4 @@
+from bluer_options.timing.elapsed_timer import ElapsedTimer
+from bluer_options.timing.classes import Timing
+
+timing = Timing()

bluer_options-5.170.1/bluer_options/timing/classes.py

@@ -0,0 +1,117 @@
+import time
+from typing import List
+from collections import defaultdict
+from functools import wraps
+
+from bluer_options import string
+from bluer_options.logger import logger
+from bluer_options.logger.config import log_list
+from bluer_options.timing.elapsed_timer import ElapsedTimer
+
+
+class Timing:
+    def __init__(self):
+        self._active = {}
+        self.stats = defaultdict(lambda: {"count": 0, "total": 0.0})
+        self.elapsed_timer = ElapsedTimer()
+
+    def start(self, keyword: str):
+        """Start timing a code block identified by 'keyword'."""
+        self._active[keyword] = time.perf_counter()
+
+    def stop(self, keyword: str):
+        """Stop timing for 'keyword' and record elapsed time."""
+        if keyword not in self._active:
+            raise RuntimeError(f"No active timer for {keyword}")
+
+        elapsed = time.perf_counter() - self._active.pop(keyword)
+        self.stats[keyword]["count"] += 1
+        self.stats[keyword]["total"] += elapsed
+
+        return elapsed
+
+    def as_list(self, **kwgrs) -> List[str]:
+        lines = []
+        # sort items by total time (descending)
+        for k, v in sorted(
+            self.stats.items(),
+            key=lambda item: item[1]["total"],
+            reverse=True,
+        ):
+            avg = v["total"] / v["count"]
+            lines.append(
+                "{}: called {:,} time(s), total {}, avg {}".format(
+                    k,
+                    v["count"],
+                    string.pretty_duration(v["total"], **kwgrs),
+                    string.pretty_duration(avg, **kwgrs),
+                )
+            )
+        return lines
+
+    def log(
+        self,
+        include_ms: bool = True,
+        largest: bool = True,
+        short: bool = True,
+        **kwargs,
+    ):
+        log_list(
+            logger,
+            "took {} for".format(
+                self.elapsed_timer.as_str(
+                    stop=False,
+                    include_ms=include_ms,
+                    largest=largest,
+                    short=short,
+                )
+            ),
+            self.as_list(
+                include_ms=include_ms,
+                largest=largest,
+                short=short,
+            ),
+            "function call(s):",
+            **kwargs,
+        )
+
+    def reset(self):
+        self._active = {}
+        self.stats = defaultdict(lambda: {"count": 0, "total": 0.0})
+        self.elapsed_timer.reset()
+
+    def time(self, arg=None):
+        """Use as @timing.time, @timing.time(), or @timing.time('custom')"""
+
+        # Case 1: @timing.time  (no parentheses, arg is the function)
+        if callable(arg):
+            func = arg
+            name = func.__name__
+
+            @wraps(func)
+            def inner(*args, **kwargs):
+                self.start(name)
+                try:
+                    return func(*args, **kwargs)
+                finally:
+                    self.stop(name)
+
+            return inner
+
+        # Case 2: @timing.time() or @timing.time("custom")
+        keyword = arg  # may be None or str
+
+        def decorator(func):
+            name = keyword or func.__name__
+
+            @wraps(func)
+            def inner(*args, **kwargs):
+                self.start(name)
+                try:
+                    return func(*args, **kwargs)
+                finally:
+                    self.stop(name)
+
+            return inner
+
+        return decorator

bluer_options-5.170.1/bluer_options/timing/elapsed_timer.py

@@ -0,0 +1,42 @@
+import time
+from bluer_options import string
+
+
+class ElapsedTimer:
+    def __init__(self):
+        self.start_time = time.time()
+        self.elapsed_time_ = None
+
+    def as_str(
+        self,
+        stop: bool = True,
+        **kwargs,
+    ):
+        if stop:
+            self.stop()
+
+        elapsed_time = self.elapsed_time
+
+        return (
+            "None"
+            if elapsed_time is None
+            else string.pretty_duration(elapsed_time, **kwargs)
+        )
+
+    @property
+    def elapsed_time(self) -> float:
+        if self.start_time is None:
+            return self.elapsed_time_
+
+        return time.time() - self.start_time
+
+    def reset(self):
+        self.start_time = time.time()
+        self.elapsed_time_ = None
+
+    def stop(self):
+        if self.start_time is None:
+            return
+
+        self.elapsed_time_ = self.elapsed_time
+        self.start_time = None

{bluer_options-5.166.1 → bluer_options-5.170.1/bluer_options.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_options
-Version: 5.166.1
+Version: 5.170.1
 Summary: 🌀 Options for Bash.
 Home-page: https://github.com/kamangir/bluer-options
 Author: Arash Abadpour (Kamangir)

{bluer_options-5.166.1 → bluer_options-5.170.1}/bluer_options.egg-info/SOURCES.txt

@@ -7,7 +7,6 @@ setup.py
 bluer_options/__init__.py
 bluer_options/__main__.py
 bluer_options/config.env
-bluer_options/elapsed_timer.py
 bluer_options/timer.py
 bluer_options/urls.py
 bluer_options.egg-info/PKG-INFO
@@ -73,4 +72,7 @@ bluer_options/string/constants.py
 bluer_options/string/functions.py
 bluer_options/terminal/__init__.py
 bluer_options/terminal/__main__.py
-bluer_options/terminal/functions.py
+bluer_options/terminal/functions.py
+bluer_options/timing/__init__.py
+bluer_options/timing/classes.py
+bluer_options/timing/elapsed_timer.py

{bluer_options-5.166.1 → bluer_options-5.170.1}/setup.py

@@ -19,6 +19,7 @@ setup(
         f"{NAME}.options",
         f"{NAME}.string",
         f"{NAME}.terminal",
+        f"{NAME}.timing",
     ],
     include_package_data=True,
     package_data={

bluer_options-5.166.1/bluer_options/elapsed_timer.py

@@ -1,23 +0,0 @@
-import time
-from bluer_options import string
-
-
-class ElapsedTimer:
-    def __init__(self):
-        self.start_time = time.time()
-        self.elapsed_time = None
-
-    def stop(self):
-        if self.start_time is None:
-            return
-
-        self.elapsed_time = time.time() - self.start_time
-        self.start_time = None
-
-    def elapsed_pretty(self, **kwargs):
-        self.stop()
-        return (
-            "None"
-            if self.elapsed_time is None
-            else string.pretty_duration(self.elapsed_time, **kwargs)
-        )