Rust时间模拟库sn_fake_clock的使用，轻松实现测试环境中的时间控制和模拟

概述

sn_fake_clock提供了一个FakeClock结构体，它模仿了std::time::Instant的接口，并能在测试期间完全控制代码感知到的时间流。

安装

在项目目录中运行以下Cargo命令：

cargo add sn_fake_clock

或者在Cargo.toml中添加以下行：

sn_fake_clock = "0.4.14"

使用示例

下面是一个完整的示例demo，展示如何使用sn_fake_clock来模拟和控制时间：

use sn_fake_clock::FakeClock;
use std::time::Duration;

#[test]
fn test_time_control() {
    // 初始化假时钟
    FakeClock::set_time(0);
    
    // 获取当前时间
    let start = FakeClock::now();
    assert_eq!(start.elapsed(), Duration::from_secs(0));
    
    // 向前推进时间
    FakeClock::advance_time(Duration::from_secs(10));
    
    // 验证时间确实前进了
    assert_eq(start.elapsed(), Duration::from_secs(10));
    
    // 设置特定时间点
    FakeClock::set_time(100);
    assert_eq(FakeClock::now().elapsed(), Duration::from_secs(100));
}

#[test]
fn test_time_dependent_logic() {
    FakeClock::set_time(0);
    
    let start = FakeClock::now();
    
    // 模拟需要等待的逻辑
    FakeClock::advance_time(Duration::from_millis(500));
    
    // 验证经过的时间
    let elapsed = start.elapsed();
    assert!(elapsed >= Duration::from_millis(500));
    assert!(elapsed < Duration::from_millis(501));
}

完整示例

use sn_fake_clock::FakeClock;
use std::time::Duration;
use std::thread;

// 测试时间控制功能
#[test]
fn test_clock_operations() {
    // 初始化时间为0
    FakeClock::set_time(0);
    
    // 验证初始时间
    let now = FakeClock::now();
    assert_eq!(now.elapsed(), Duration::from_secs(0));
    
    // 前进5秒
    FakeClock::advance_time(Duration::from_secs(5));
    assert_eq!(now.elapsed(), Duration::from_secs(5));
    
    // 前进500毫秒
    FakeClock::advance_time(Duration::from_millis(500));
    assert_eq!(now.elapsed(), Duration::from_millis(5500));
    
    // 直接设置时间为10秒
    FakeClock::set_time(10_000);
    assert_eq!(FakeClock::now().elapsed(), Duration::from_millis(10_000));
}

// 测试时间敏感逻辑
#[test]
fn test_time_sensitive_operations() {
    FakeClock::set_time(0);
    
    // 记录开始时间
    let start = FakeClock::now();
    
    // 模拟耗时操作
    FakeClock::advance_time(Duration::from_secs(3));
    
    // 检查耗时
    assert_eq!(start.elapsed(), Duration::from_secs(3));
    
    // 模拟短时间等待
    FakeClock::advance_time(Duration::from_millis(250));
    assert_eq!(start.elapsed(), Duration::from_millis(3250));
}

// 测试定时器功能
#[test]
fn test_timer_functionality() {
    FakeClock::set_time(0);
    
    let timer_start = FakeClock::now();
    
    // 模拟定时器超时（1秒后）
    FakeClock::advance_time(Duration::from_secs(1));
    
    // 检查是否超时
    assert!(timer_start.elapsed() >= Duration::from_secs(1));
    assert!(timer_start.elapsed() < Duration::from_secs(2));
    
    // 再前进500毫秒
    FakeClock::advance_time(Duration::from_millis(500));
    assert_eq!(timer_start.elapsed(), Duration::from_millis(1500));
}

主要功能

1. 设置特定时间点：使用FakeClock::set_time可以直接设置时钟到特定时间
2. 前进时间：使用FakeClock::advance_time可以模拟时间的流逝
3. 获取当前时间：FakeClock::now()返回一个类似Instant的对象，可以测量时间间隔

许可证

这个SAFE Network库采用双重许可：

• 修改后的BSD许可证
• MIT许可证

您可以选择其中一种。

贡献

欢迎贡献！无论是编写新代码、修复bug还是报告错误，所有形式的贡献都受到鼓励。