iterum 0.1.0

A utility macro for supporting multiple versions of a struct.
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

pub use iterum_macros::*;

#[cfg(doctest)]
mod doctests {
	/// ```compile_fail
	/// #[iterum::versioned]
	/// struct User {
	///   field: String,
	/// }
	fn test_no_versioning_set() {}

	/// ```compile_fail
	/// #[iterum::versioned(semver)]
	/// struct User {}
	/// ```
	fn test_no_fields() {}
}

#[cfg(test)]
#[allow(unused)]
mod tests {
	use serde::{Deserialize, Serialize};

	use super::*;

	#[test]
	fn test_serde() {
		#[versioned(semver, serde)]
		#[derive(Deserialize, Serialize)]
		struct User {
			field: String,
		}

		let user = User::V0_0_0(UserV0_0_0 {
			field: "hello".into(),
		});
	}

	#[test]
	fn test_serde_borrow() {
		#[versioned(semver, serde)]
		#[derive(Deserialize, Serialize)]
		struct User<'a> {
			field: &'a str,
		}

		let user = User::V0_0_0(UserV0_0_0 { field: "hello" });
	}

	#[test]
	fn test_overwrite_field() {
		#[versioned(semver)]
		struct User {
			#[versioned(until = "1.0.0")]
			field: String,
			#[versioned(since = "1.0.0")]
			field: u32,
		}

		let v0 = User::V0_0_0(UserV0_0_0 {
			field: "hello".into(),
		});

		let v1 = User::V1_0_0(UserV1_0_0 { field: 42 });
	}

	fn test_generics() {
		#[versioned(semver)]
		struct User<'a, A> {
			#[versioned(until = "1.0.0")]
			field: &'a str,
			field2: A,
			#[versioned(since = "1.0.0")]
			field: String,
		}

		let v0 = User::V0_0_0(UserV0_0_0 {
			field: "hello",
			field2: 42,
		});

		let v1 = User::V1_0_0(UserV1_0_0 {
			field: "hello".into(),
			field2: (),
		});
	}
}