summaryrefslogtreecommitdiff
path: root/stopwatch.py
blob: 4e69b6992b278df8eb8e725954d9c610468318aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
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, Literal


class Timer(contextlib.AbstractContextManager):
    """
    A stopwatch to time how long something takes (walltime).

    e.g.

        with stopwatch.Timer() as t:
            do_the_thing()

        walltime = t()
        print(f'That took {walltime} seconds.')
    """

    def __init__(self) -> None:
        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) -> Literal[False]:
        self.end = time.perf_counter()
        return False