fast-able 1.20.2

The world's martial arts are fast and unbreakable; 天下武功 唯快不破
Documentation
use std::{fmt::Display, time::Duration};

/// Record elapsed time functionality
/// 记录耗时的功能
#[derive(Debug, Clone)]
pub struct ElapsedTime {
    pub start_time: std::time::Instant,
    elapsed_logs: Vec<(&'static str, Duration)>,
    total: Duration,
}

impl Display for ElapsedTime {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(&self.print())
    }
}

impl ElapsedTime {
    /// Create a new ElapsedTime instance
    /// 创建一个新的 ElapsedTime 实例
    pub fn new(capacity: usize) -> Self {
        Self {
            start_time: std::time::Instant::now(),
            elapsed_logs: Vec::with_capacity(capacity),
            total: Duration::ZERO,
        }
    }

    /// Log a checkpoint with a message
    /// 记录一个带有消息的检查点
    pub fn log(&mut self, log: &'static str) {
        let el = self.start_time.elapsed();
        let el2 = el - self.total;
        self.total = el;
        self.elapsed_logs.push((log, el2));
    }

    /// Print logs if total time exceeds limit
    /// 如果总时间超过限制则打印日志
    pub fn print_limit(&self, limit: Duration) -> Option<String> {
        if self.total < limit {
            return None;
        }
        Some(self.print())
    }

    /// Format the logs into a string
    /// 将日志格式化为字符串
    pub fn print(&self) -> String {
        let logs = self
            .elapsed_logs
            .iter()
            .map(|(log, el)| format!("{log}: {el:?}"))
            .collect::<Vec<_>>()
            .join(", ");

        format!("Elapsed; total: {:?}, {logs}", self.total)
    }
}

#[test]
fn test_ElapsedTime() {
    let mut elapsed_time = ElapsedTime::new(10);
    for i in 0..10 {
        std::thread::sleep(std::time::Duration::from_millis(i * 100));
        elapsed_time.log("log");
    }
    println!("{}", elapsed_time.print());
}