Utility function for timeit module - call a function with optional args and print statistics about timeit results

timedec.py

def timedec(*args, func=None, repeat=5, number=1000000):
    import timeit
    from functools import partial
    import statistics

    def dec(f):
        p = partial(f, *args)
        pname = f"{f.__name__}({', '.join(map(str, args))})"
        
        result = timeit.Timer(p).repeat(repeat, number)

        mean = statistics.mean(result)
        stdev = statistics.stdev(result)
        max_ = max(result)
        min_ = min(result)
        sum_ = sum(result)

        print(
            f'timing {pname} with {number} iterations, {repeat} trials\n'
            f'  mean: {mean:.5f}s, stdev: {stdev:.5f}s\n'
            f'  min: {min_:.5f}s, max: {max_:.5f}s, sum: {sum_:.5f}s\n'
        )
        
        return f

    if func is not None:
        return dec(func)

    return dec