跳转到主要内容

面向人类的Python计时模块。

项目描述

简单的标记时间Python模块。

受node.js中的两个函数的启发

主要功能

  • 易于使用

  • 无外部依赖

  • 100%测试覆盖率

  • 适用于Python 2.7和3.3

用法

$ pip install marktime
import marktime

marktime.start('some task')
marktime.start('some another task')

marktime.stop('some task')
8.757422924041748

marktime.stop('some another task').seconds
14.805735111236572

marktime.duration('some another task').msecs
14805.735111236572

marktime.start('some task # 3')

with marktime.stopwatch('some task # 4'):
    marktime.time.sleep(1)

import json
print json.dumps(marktime.labels, indent=4)
{
    "some another task": {
        "duration": 14.805735111236572,
        "start_time": 1370453758.064955,
        "end_time": 1370453772.87069
    },
    "some task # 3": {
        "start_time": 1370453892.025603,
        "end_time": None
    },
    "some task # 4": {
        "duration": 1.00120210647583,
        "start_time": 1370638027.000799,
        "end_time": 1370638028.002001
    },
    "some task": {
        "duration": 8.757422924041748,
        "start_time": 1370453753.185846,
        "end_time": 1370453761.943269
    }
}

API

  • marktime.start (label, at=None)

    • label — 标记标签。字符串。必需。

    • at — 开始倒计时的时间。如果为None,则使用time.time()

  • marktime.stop (label, remove_from_labels=False, stop_once=True)

    • label — 标记标签。字符串。必需。

    • at — 停止倒计时的时间。如果为None,则使用time.time()

    • remove_from_labels — 如果为True,则从全局字典marktime.labels中删除label

    • stop_once — 如果为False,并且该label的倒计时已经停止,则再次停止它。此后,该label的持续时间将增加。

  • marktime.duration (label, stop_it=True, stop_at=None)

    • label — 标记标签。字符串。必需。

    • stop_it — 如果为True,则停止该label的倒计时。如果为False,并且该label的倒计时未停止,则返回None

    • stop_at — 当 stop_it == True 时传递给 stop 函数

  • marktime.stopwatch (标签) — 上下文管理器(支持 with 语句)

  • marktime.labels — 存储所有时间标记标签的全局 dict

许可证

请参阅 授权文件

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码发行版

marktime-0.2.0.tar.gz (3.2 kB 查看散列值)

上传时间 源代码

由以下支持