Skip to main content

Utilities for measuring application performance

Project description

Simple utilities to make it easier to track performance of Python programs under normal operations

Context Managers


This context manager makes it easy to display console-oriented start/end messages with end-user tolerable formatting.


with DisplayElapsed("{now} uploading {filename} (original: {original})\n",
                    "{now} uploaded {filename} in {elapsed:.1f} seconds",
                    filename=remote_path, original=local_path):


  • DisplayElapsed takes one positional argument: message. The message is formatted using str.format with the values {now} and {elapsed} provided automatically. All other keyword arguments provided to DisplayElapsed will be available during formatting.

  • If message contains {{now}} it will be replaced with the current timestamp

  • If message does not contain {{now}} it will be prepended unless include_timestamp=False

  • If postamble is not specified, it will default to " ({elapsed:.1f} seconds)"

  • If output is not specified, it will default to sys.stdout

  • If output_on_error is not True, the normal postamble display will be suppressed when an exception occurs

  • By default, a newline will not be emitted after the opening message so the message and postamble will be displayed on a single line. output will be flushed, if supported, to provide immediate feedback. Provide a message which ends in \n if you want multi-line output.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

performance_tools-0.3.tar.gz (6.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page