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.

Files for performance_tools, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size performance_tools-0.3.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page