rubedo 0.6.4

Library of useful functionality and extensions
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

//		Packages																										

use super::*;
use core::any::type_name;
use std::collections::HashSet;



//		Tests																											

//		s!																		
#[cfg(test)]
mod s {
	use super::*;
	
	//		type_of																
	fn type_of<T>(_: &T) -> &'static str {
		type_name::<T>()
	}
	
	//		s!																	
	#[test]
	fn s__empty() {
		assert_eq!(s!(), "");
		assert_eq!(s!(), String::new());
	}
	#[test]
	fn s__str() {
		assert_eq!(s!("foo"), "foo");
		assert_eq!(s!("foo"), String::from("foo"));
	}
	#[test]
	fn s__string() {
		assert_eq!(s!(String::from("foo")), "foo");
		assert_eq!(s!(String::from("foo")), String::from("foo"));
	}
	#[test]
	fn s__int() {
		//	This tests that although the macro is intended for use with str slice
		//	literals, it will also work with other types providing they have a
		//	to_owned() function - the outcome will not be a String, which will not
		//	match expectations, but it will still work. Really, the macro should not
		//	be used in this way, as it is only designed for use with str literals.
		assert_eq!(s!(42), 42);
	}
	#[test]
	fn s__types() {
		assert_ne!(type_of(&"foo"),     type_of(&String::from("foo")));
		assert_eq!(type_of(&s!("foo")), type_of(&String::from("foo")));
	}
}

//		variants!																
#[cfg(test)]
mod variants {
	use super::*;
	
	//		Position															
	#[derive(Copy, Clone, Debug, Eq, PartialEq)]
	#[repr(u8)]
	enum Position {
		Zero = 0,
		One  = 1,
		Two  = 2,
	}
	
	//		variants!															
	#[test]
	#[expect(trivial_casts, reason = "Trivial cast here is needed for the test")]
	fn variants__empty() {
		assert_eq!(variants![] as Vec<Position>, vec![]);
		assert_eq!(variants!() as Vec<Position>, vec![]);
		assert_eq!(variants!{} as Vec<Position>, vec![]);
		assert_eq!(variants![ Position: ], vec![]);
		assert_eq!(variants!( Position: ), vec![]);
		assert_eq!(variants!{ Position: }, vec![]);
	}
	#[test]
	fn variants__single() {
		assert_eq!(variants![ Position: One  ], vec![ Position::One ]);
		assert_eq!(variants![ Position: One, ], vec![ Position::One ]);
		assert_eq!(variants!( Position: One  ), vec![ Position::One ]);
		assert_eq!(variants!{ Position: One, }, vec![ Position::One ]);
	}
	#[test]
	fn variants__multiple() {
		assert_eq!(variants![ Position: Zero, One      ], vec![ Position::Zero, Position::One ]);
		assert_eq!(variants![ Position: Zero, One,     ], vec![ Position::Zero, Position::One ]);
		assert_eq!(variants![ Position: Zero, One, Two ], vec![ Position::Zero, Position::One, Position::Two ]);
		assert_eq!(variants!( Position: Zero, One, Two ), vec![ Position::Zero, Position::One, Position::Two ]);
		assert_eq!(variants!{ Position: Zero, One, Two }, vec![ Position::Zero, Position::One, Position::Two ]);
	}
}

//		variants_hashset!														
#[cfg(test)]
mod variants_hashset {
	use super::*;
	
	//		Position															
	#[derive(Copy, Clone, Debug, Eq, Hash, PartialEq)]
	#[repr(u8)]
	enum Position {
		Zero = 0,
		One  = 1,
		Two  = 2,
	}
	
	//		variants_hashset!													
	#[test]
	#[expect(trivial_casts, reason = "Trivial cast here is needed for the test")]
	fn variants__empty() {
		assert_eq!(variants_hashset![] as HashSet<Position>, HashSet::new());
		assert_eq!(variants_hashset!() as HashSet<Position>, HashSet::new());
		assert_eq!(variants_hashset!{} as HashSet<Position>, HashSet::new());
		assert_eq!(variants_hashset![ Position: ], HashSet::new());
		assert_eq!(variants_hashset!( Position: ), HashSet::new());
		assert_eq!(variants_hashset!{ Position: }, HashSet::new());
	}
	#[test]
	fn variants__single() {
		assert_eq!(variants_hashset![ Position: One  ], HashSet::from([ Position::One ]));
		assert_eq!(variants_hashset![ Position: One, ], HashSet::from([ Position::One ]));
		assert_eq!(variants_hashset!( Position: One  ), HashSet::from([ Position::One ]));
		assert_eq!(variants_hashset!{ Position: One, }, HashSet::from([ Position::One ]));
	}
	#[test]
	fn variants__multiple() {
		assert_eq!(variants_hashset![ Position: Zero, One      ], HashSet::from([ Position::Zero, Position::One ]));
		assert_eq!(variants_hashset![ Position: Zero, One,     ], HashSet::from([ Position::Zero, Position::One ]));
		assert_eq!(variants_hashset![ Position: Zero, One, Two ], HashSet::from([ Position::Zero, Position::One, Position::Two ]));
		assert_eq!(variants_hashset!( Position: Zero, One, Two ), HashSet::from([ Position::Zero, Position::One, Position::Two ]));
		assert_eq!(variants_hashset!{ Position: Zero, One, Two }, HashSet::from([ Position::Zero, Position::One, Position::Two ]));
	}
}