k3stopwatch 0.1.2

Hierarchical timing measurement with aggregated and tracing reports

k3stopwatch

StopWatch - library for adding timers and tags in your code for performance monitoring

k3stopwatch is a component of pykit3 project: a python3 toolkit set.

StopWatch operates on a notion of "spans" which represent scopes of code for which we want to measure timing. Spans can be nested and placed inside loops for aggregation.

StopWatch requires a root scope which upon completion signifies the end of the round of measurements. On a server, you might use a single request as your root scope.

StopWatch produces two kinds of reports.

1. Aggregated (see _reported_values).
2. Non-aggregated or "tracing" (see _reported_traces).

Install

pip install k3stopwatch

Synopsis

import k3stopwatch
sw  = k3stopwatch.StopWatch()

with sw.timer('rwoot'):
    for i in range(50):
         with sw.timer('inner_task'):
             print("do_inner_task(i)")

Author

Zhang Yanpo (张炎泼) [e-mail]

Copyright and License

The MIT License (MIT)

Copyright (c) 2015 Zhang Yanpo (张炎泼) [e-mail]