keysmith 0.4.0

Create keys, uuid's, timestamps, and more.
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
138
139
140
141
142
143
144

//! Generates a UUID.
//!
//! Currently only version 4 or "nonstandard".
//!
//! Nonstandard is the same as v4 but uses a-z instead of just a-f.

use crate::char::char_uuid;

/// UUID version
#[derive(Debug, Clone, Copy)]
pub enum UUID {
	V4,
	Nonstandard,
}

/// Generate a UUID.
///
/// The version input should be a UUID enum.
///
/// v4 Ex: fc402d52-70be-7f09-caed-8da65db08985
///
/// nonstandard Ex: eko0c6ph-k2ok-60rr-pj78-mns182t9vurf
fn gen_uuid(version: UUID, separators: bool) -> String {
	let mut output = String::from("");
	let mut c: char;

	// first set of digits
	for _n in 1..=8 {
		c = char_uuid(version);

		output.push(c);
	}

	if separators {
		output.push('-'); // Current state: fc402d52-
	}

	// second through fourth sets of digits
	for _n in 1..=3 {
		for _x in 1..=4 {
			c = char_uuid(version);
			output.push(c);
		}

		if separators {
			output.push('-');
		}
		// After one loop: efc402d52-70be-
	}

	// Current state: fc402d52-70be-7f09-caed-

	// final set of digits
	for _n in 1..=12 {
		c = char_uuid(version);
		output.push(c);
	}

	output // fc402d52-70be-7f09-caed-8da65db08985
}

// Public API

/// Generate a UUID (version 4).
///
/// This is exactly the same as uuid4(),
/// but here for API simplicity.
///
/// ex: fc402d52-70be-7f09-caed-8da65db08985
pub fn uuid() -> String {
	uuid4()
}

/// Generate a UUID (version 4).
///
/// ex: fc402d52-70be-7f09-caed-8da65db08985
pub fn uuid4() -> String {
	gen_uuid(UUID::V4, true)
}

/// Generate a UUID (nonstandard).
/// This is the same as a v4, but letters can be
/// a-z instead of just a-f.
///
/// ex: l8fx3px5-9lyk-gzrb-iu75-d4gp63chor9z
pub fn uuidn() -> String {
	gen_uuid(UUID::Nonstandard, true)
}

/// Generate a UUID (version 4)
/// without separators.
///
/// This is exactly the same as uuid4_no_seps(),
/// but here for API simplicity.
///
/// ex: fc402d5270be7f09caed8da65db08985
pub fn uuid_no_seps() -> String {
	uuid4_no_seps()
}

/// Generate a UUID (version 4)
/// without separators.
///
/// ex: fc402d5270be7f09caed8da65db08985
pub fn uuid4_no_seps() -> String {
	gen_uuid(UUID::V4, false)
}

/// Generate a UUID (nonstandard)
/// without separators.
///
/// This is the same as a v4, but letters can be
/// a-z instead of just a-f.
///
/// ex: l8fx3px59lykgzrbiu75d4gp63chor9z
pub fn uuidn_no_seps() -> String {
	gen_uuid(UUID::Nonstandard, false)
}

// Tests

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

	#[test]
	fn test_uuid4() {
		let success = test_valid_uuid(UUID::V4);

		if !success {
			panic!("uuid4() generated an invalid uuid.");
		}
	}

	#[test]
	fn test_uuidn() {
		let success = test_valid_uuid(UUID::Nonstandard);

		if !success {
			panic!("uuidn() generated an invalid uuid.");
		}
	}
}