X-Git-Url: https://wannabe.guru.org/gitweb/?a=blobdiff_plain;f=stopwatch.py;h=4e69b6992b278df8eb8e725954d9c610468318aa;hb=532df2c5b57c7517dfb3dddd8c1358fbadf8baf3;hp=752c7ed2d39268364d801391ce108768d2763f0c;hpb=0e451d3b3bf899b3d9ac0c38e3c3cd9d9be170ba;p=python_utils.git

diff --git a/stopwatch.py b/stopwatch.py
index 752c7ed..4e69b69 100644
--- a/stopwatch.py
+++ b/stopwatch.py
@@ -1,28 +1,39 @@
 #!/usr/bin/env python3
 
+# © Copyright 2021-2022, Scott Gasch
+
+"""A simple stopwatch decorator / context for timing things."""
+
+import contextlib
 import time
-from typing import Callable
+from typing import Callable, Literal
 
 
-class Timer(object):
+class Timer(contextlib.AbstractContextManager):
     """
-    with timer.Timer() as t:
-        do_the_thing()
+    A stopwatch to time how long something takes (walltime).
+
+    e.g.
 
-    walltime = t()
-    print(f'That took {walltime}s.')
+        with stopwatch.Timer() as t:
+            do_the_thing()
+
+        walltime = t()
+        print(f'That took {walltime} seconds.')
     """
 
     def __init__(self) -> None:
-        self.start = None
-        self.end = None
-        pass
+        self.start = 0.0
+        self.end = 0.0
 
     def __enter__(self) -> Callable[[], float]:
+        """Returns a functor that, when called, returns the walltime of the
+        operation in seconds.
+        """
         self.start = time.perf_counter()
         self.end = 0.0
         return lambda: self.end - self.start
 
-    def __exit__(self, *args) -> bool:
+    def __exit__(self, *args) -> Literal[False]:
         self.end = time.perf_counter()
-        return True
+        return False