inventory_kit 0.1.2

A powerful Rust toolkit for dynamic inventory management and integration.
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

use crate::error::InventoryError;

/// Validates that a given time range is logically correct and within bounds.
///
/// This utility is meant to be reused by implementations that use time as `u32`-like values,
/// where times are expected to be in a 24-hour format (e.g., `1300` for 1:00 PM).
///
/// # Parameters
/// - `start_time`: The starting time of the range.
/// - `end_time`: The ending time of the range.
///
/// # Returns
/// - `Ok(())` if the time range is valid.
/// - `Err(InventoryError::InvalidTimeRange)` if `end_time` is not greater than `start_time`.
/// - `Err(InventoryError::Internal)` if conversion to `u32` fails or time exceeds 2400.
///
/// # Type Constraints
/// - `Time` must implement `Copy` and `TryInto<u32>`, which allows flexible generic usage.
///
/// # Examples
/// ```
/// use inventory_kit::utils::validate_time_range;
/// assert!(validate_time_range(900u32, 1200u32).is_ok());
/// assert!(validate_time_range(1500u32, 1400u32).is_err());
/// ```
pub fn validate_time_range<Time: Copy + TryInto<u32>>(
    start_time: Time,
    end_time: Time,
) -> Result<(), InventoryError> {
    let start: u32 = start_time.try_into().map_err(|_| {
        InventoryError::Internal("Failed to convert start_time to u32".to_string())
    })?;
    let end: u32 = end_time.try_into().map_err(|_| {
        InventoryError::Internal("Failed to convert end_time to u32".to_string())
    })?;

    if end <= start {
        return Err(InventoryError::InvalidTimeRange);
    }

    if end >= 2400 {
        return Err(InventoryError::Internal("Time must be less than 2400".to_string()));
    }

    Ok(())
}