ggen-core 26.5.19

Core graph-aware code generation engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! Time utilities for ggen
//!
//! This module provides utilities for working with timestamps and durations,
//! including Unix timestamp generation and human-readable duration formatting.
//!
//! ## Features
//!
//! - **Unix timestamps**: Get current Unix timestamp
//! - **Duration formatting**: Format durations in human-readable format
//! - **Time calculations**: Helper functions for time-based operations
//!
//! ## Examples
//!
//! ### Getting Current Timestamp
//!
//! ```rust
//! use crate::utils::time::current_timestamp;
//!
//! # fn main() {
//! let timestamp = current_timestamp();
//! println!("Current Unix timestamp: {}", timestamp);
//! # }
//! ```
//!
//! ### Formatting Durations
//!
//! ```rust
//! use crate::utils::time::format_duration;
//!
//! # fn main() {
//! assert_eq!(format_duration(30), "30s");
//! assert_eq!(format_duration(90), "1m 30s");
//! assert_eq!(format_duration(3661), "1h 1m 1s");
//! # }
//! ```

use std::time::{SystemTime, UNIX_EPOCH};

/// Get the current Unix timestamp.
///
/// # Panics
///
/// Panics if the system time is before the Unix epoch.
#[must_use]
pub fn current_timestamp() -> u64 {
    SystemTime::now()
        .duration_since(UNIX_EPOCH)
        .expect("System time should not be before Unix epoch")
        .as_secs()
}

/// Format a duration in seconds to a human-readable string.
#[must_use]
pub fn format_duration(secs: u64) -> String {
    if secs < 60 {
        format!("{secs}s")
    } else if secs < 3600 {
        format!("{}m {}s", secs / 60, secs % 60)
    } else {
        format!("{}h {}m {}s", secs / 3600, (secs % 3600) / 60, secs % 60)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_current_timestamp() {
        let timestamp = current_timestamp();
        assert!(timestamp > 0);

        // Should be reasonable (after year 2020)
        assert!(timestamp > 1_577_836_800); // Jan 1, 2020
    }

    #[test]
    fn test_format_duration_seconds() {
        assert_eq!(format_duration(0), "0s");
        assert_eq!(format_duration(30), "30s");
        assert_eq!(format_duration(59), "59s");
    }

    #[test]
    fn test_format_duration_minutes() {
        assert_eq!(format_duration(60), "1m 0s");
        assert_eq!(format_duration(90), "1m 30s");
        assert_eq!(format_duration(125), "2m 5s");
        assert_eq!(format_duration(3599), "59m 59s");
    }

    #[test]
    fn test_format_duration_hours() {
        assert_eq!(format_duration(3600), "1h 0m 0s");
        assert_eq!(format_duration(3661), "1h 1m 1s");
        assert_eq!(format_duration(7325), "2h 2m 5s");
    }
}