pytimer

Copyright (c) 2013-2018 brinkqiang ([email protected])

Build status

Linux	Mac	Windows

项目介绍

pytimer 是一个高性能的 Python 定时器模块，基于 C++ 实现并通过 pybind11 提供 Python 接口。它提供了精确的定时功能，适用于需要高精度定时器的场景。

主要特性：

• 高精度定时
• 多线程支持
• 跨平台（Linux/Mac/Windows）
• 简单易用的 API

安装

从源码构建

1. 克隆仓库：

   git clone https://github.com/brinkqiang/pytimer.git
   cd pytimer

2. 构建项目：

   • Linux/Mac:

     ./build.sh

   • Windows:

     build.bat

使用示例

# -*- coding: utf-8 -*-
import pytimer

timer = pytimer.CPyTimer()

def main_idle(id):
    print(f"{pytimer.gettime()} [{id}] hello main_idle")

timer.settimer(1, 1000, main_idle)

print(f"{pytimer.gettime()} sleepms start")

# 嵌套回调实现
# warning: sleepms bind IDEvent=0
timer.sleepms(2000, lambda : (
    (lambda count=[0]: (  # 闭包捕获可变对象
        print(f"{pytimer.gettime()} [0] sleepms 2000"),
        timer.settimer(2, 1000, lambda id: (
            (lambda count=count: (
                count.__setitem__(0, count[0] + 1),
                print(f"{pytimer.gettime()} [{id}] hello world {count[0]}"),
                count[0] >= 10 and (
                    timer.killtimer(id),
                    timer.killall(),
                    pytimer.stop()
                )
            ))()
        ))
    ))()
))

pytimer.run()

• gtest output

Running main() from gtest_main.cc
[==========] Running 1 test from 1 test case.
[----------] Global test environment set-up.
[----------] 1 test from TimerTest
[ RUN      ] TimerTest.BasicTimerOperation
2025-03-08 14:22:38 sleepms start
2025-03-08 14:22:39 [1] hello main_idle
2025-03-08 14:22:40 [0] sleepms 2000
2025-03-08 14:22:40 [1] hello main_idle
2025-03-08 14:22:41 [1] hello main_idle
2025-03-08 14:22:41 [2] hello world 1
2025-03-08 14:22:42 [1] hello main_idle
2025-03-08 14:22:42 [2] hello world 2
2025-03-08 14:22:43 [1] hello main_idle
2025-03-08 14:22:43 [2] hello world 3
2025-03-08 14:22:44 [1] hello main_idle
2025-03-08 14:22:44 [2] hello world 4
2025-03-08 14:22:45 [1] hello main_idle
2025-03-08 14:22:45 [2] hello world 5
2025-03-08 14:22:46 [1] hello main_idle
2025-03-08 14:22:46 [2] hello world 6
2025-03-08 14:22:47 [1] hello main_idle
2025-03-08 14:22:47 [2] hello world 7
2025-03-08 14:22:48 [1] hello main_idle
2025-03-08 14:22:48 [2] hello world 8
2025-03-08 14:22:49 [1] hello main_idle
2025-03-08 14:22:49 [2] hello world 9
2025-03-08 14:22:50 [1] hello main_idle
2025-03-08 14:22:50 [2] hello world 10
[       OK ] TimerTest.BasicTimerOperation (12060 ms)
[----------] 1 test from TimerTest (12061 ms total)

[----------] Global test environment tear-down
[==========] 1 test from 1 test case ran. (12062 ms total)
[  PASSED  ] 1 test.

贡献指南

我们欢迎任何形式的贡献！请遵循以下步骤：

1. Fork 本项目
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。