用“从约束列表中选择时钟”get_clock()和get_clocks()函数实现pep0418
cs.clockutils的Python项目详细描述
一种按功能表示系统时钟的框架,旨在避免 图书馆作为政治公众人物418讨论的政策陷阱。
我的2c:
- http://www.gossamer-threads.com/lists/python/dev/977474#977474
- http://www.gossamer-threads.com/lists/python/dev/977495#977495 或:
- http://www.mail-archive.com/python-dev@python.org/msg66174.html
- http://www.mail-archive.com/python-dev@python.org/msg66179.html
- 卡梅隆·辛普森2012年4月2日
类BaseClock
基钟是时钟对象的私有基类。
时钟具有以下必需属性:
.flags
:描述时钟的特征标志。
时钟可能具有以下可选属性:
.epoch
: 如果存在,则从time.time()的纪元偏移 时钟的纪元()。不是所有的钟都有年代;有些测量 从未知点经过的时间 在两个测量中是有用的。.resolution
: 基本时钟设备的分辨率 报告单位。时钟永远不会比 这个值。报告时间的实际准确性可能 随着调整和实际精度的变化 底层操作系统时钟设施(反过来可能是 取决于某些硬件时钟的精度)。
时钟还必须提供以下方法:
.now()
:以秒为单位报告当前时间,浮点数。
类ClockEntry
mro:builtins.tuple
时钟输入(标志,工厂)
类ClockFlags
mro:builtins.int
一个int,带有对时钟标志友好的str()和repr()。
标志名称为:
HIGHRES
:具有最高分辨率的时钟。MONOTONIC
:时钟不会倒转。STEADY
:具有高稳定度的时钟 相对较高的精度和精度。ADJUSTED
:其值可能更改的时钟 到正确的时间。WALLCLOCK
:墙上的钟显示了什么。RUNTIME
:基于进程运行时间的时钟。SYNTHETIC
:从其他时钟计算的时钟, 例如从另一个 非单调时钟。
函数get_clock(flags=0, clocklist=None)
根据提供的flags
返回时钟。
返回的时钟应具有所有要求的标志。
如果没有时钟匹配,则返回“无”。
函数get_clocks(flags=0, clocklist=None)
生成与提供的flags
匹配的所有时钟。
返回的时钟应具有所有要求的标志。
函数highres()
根据默认的高分辨率时钟返回当前时间。
函数highres_clock(other_flags=0)
返回高分辨率时钟,最好是稳定的。
函数monotonic()
根据默认的单调时钟返回当前时间。
函数monotonic_clock(other_flags=0)
返回单调时钟,最好是高分辨率。
函数steady()
根据默认的稳定时钟返回当前时间。
函数steady_clock(other_flags=0)
返回一个稳定的时钟,最好是高分辨率。
类SyntheticMonotonic
mro:BaseClock
一个合成时钟的例子。
这个类在time.time()之后,因为我认为 时钟应该不那么理想-它们往往有边 效果;但可能是因为他们可以提供 系统时钟不总是显示标志组合。
一个简单的合成单调时钟可能会相对于另一个 实例。 史蒂文·达帕拉诺写了一个更好的。