summaryrefslogtreecommitdiff
path: root/stopwatch.py
blob: ae8e01aa18452ed932ef589b9047c7f0c68ab58a (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
#!/usr/bin/env python3

"""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