preprocess 0.5.10

Preprocesses a struct with built-in preprocessors
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

use crate::utils::Error;

/// Validates that the given `value` is inside the defined range. The `max` and
/// `min` parameters are optional and will only be validated if they are not
/// `None`
#[must_use = concat!(
	"validation returns a new value instead of mutating the input.",
	" The returned value will contain the validated value,",
	" while the input will remain unchanged"
)]
pub fn validate_range<T>(
	value: T,
	min: Option<T>,
	max: Option<T>,
) -> Result<T, Error>
where
	T: PartialOrd + PartialEq,
{
	if let Some(max) = max &&
		value > max
	{
		return Err(Error::new(
			"value must be less than or equal to the maximum",
		));
	}

	if let Some(min) = min &&
		value < min
	{
		return Err(Error::new(
			"value must be greater than or equal to the minimum",
		));
	}

	Ok(value)
}

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

	#[test]
	fn test_validate_range_generic_ok() {
		// Unspecified generic type:
		assert_eq!(validate_range(10, Some(-10), Some(10)), Ok(10));
		assert_eq!(validate_range(0.0, Some(0.0), Some(10.0)), Ok(0.0));

		// Specified type:
		assert_eq!(validate_range(5u8, Some(0), Some(255)), Ok(5u8));
		assert_eq!(validate_range(4u16, Some(0), Some(16)), Ok(4u16));
		assert_eq!(validate_range(6u32, Some(0), Some(23)), Ok(6u32));
	}

	#[test]
	fn test_validate_range_generic_fail() {
		assert!(validate_range(5, Some(17), Some(19)).is_err());
		assert!(validate_range(-1.0, Some(0.0), Some(10.0)).is_err());
	}

	#[test]
	fn test_validate_range_generic_min_only() {
		assert!(validate_range(5, Some(10), None).is_err());
		assert_eq!(validate_range(15, Some(10), None), Ok(15));
	}

	#[test]
	fn test_validate_range_generic_max_only() {
		assert_eq!(validate_range(5, None, Some(10)), Ok(5));
		assert!(validate_range(15, None, Some(10)).is_err());
	}
}