performance_tools 0.3

上下文管理器

displayElapsed

此上下文管理器使显示面向控制台的开始/结束消息变得容易，最终用户可以接受 格式化。

用法：

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

注意：

• displayeapsed接受一个位置参数：message消息的格式是使用 str.format值为{now} 以及自动提供的{elapsed}。提供给DisplayElapsed的所有其他关键字参数将是 在格式化期间可用
• 如果message包含{{now}}，则它将替换为当前时间戳
• 如果message不包含{{now}}，则它将被前置，除非include_timestamp=False
• 如果未指定postamble，则默认为" ({elapsed:.1f} seconds)"
• 如果未指定output，则默认为sys.stdout
• 如果output_on_error不是真的，则当发生异常时，正常的后码显示将被抑制
• 默认情况下，在打开邮件后不会发出换行符，因此邮件和邮政编码将 显示在一行上。output将被刷新（如果支持），以提供即时反馈。 如果需要多行输出，请提供以\n结尾的消息。