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

import time
from typing import Callable, Optional


class Timer(object):
    """
    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) -> Optional[bool]:
        self.end = time.perf_counter()
        return None  # don't suppress exceptions