wary 0.3.1

A simple validation and transformation library.
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

//! Rule for semantic versioning validation.
//!
//! See [`SemverRule`] for more information.

use crate::toolbox::rule::*;

#[doc(hidden)]
pub type Rule = SemverRule;

#[derive(Debug, thiserror::Error, PartialEq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize), serde(untagged))]
pub enum Error {
	#[error("expected semantic version")]
	Semver,
}

impl Error {
	#[must_use]
	pub(crate) fn code(&self) -> &'static str {
		match self {
			Self::Semver => "semver",
		}
	}

	pub(crate) fn message(&self) -> &'static str {
		match self {
			Self::Semver => "expected semantic version",
		}
	}
}

/// Rule for semantic versioning validation.
///
/// # Example
///
/// ```
/// use wary::{Wary, Validate};
///
/// #[derive(Wary)]
/// struct Version {
///   #[validate(semver)]
///   version: &'static str,
/// }
///
/// let version = Version { version: "1.2.3" };
/// assert!(version.validate(&()).is_ok());
///
/// let version = Version { version: "1.2.3-alpha" };
/// assert!(version.validate(&()).is_ok());
///
/// let version = Version { version: "blah" };
/// assert!(version.validate(&()).is_err());
/// ```
#[must_use]
pub struct SemverRule;

impl SemverRule {
	#[inline]
	pub const fn new() -> Self {
		Self
	}
}

impl<I: ?Sized> crate::Rule<I> for SemverRule
where
	I: AsRef<str>,
{
	type Context = ();

	#[inline]
	fn validate(&self, _ctx: &Self::Context, item: &I) -> Result<()> {
		let version = item.as_ref();

		// TODO: https://github.com/dtolnay/semver/issues/326
		version
			.parse::<semver::Version>()
			.map_err(|_| Error::Semver)?;

		Ok(())
	}
}

mod test {
	use crate::toolbox::test::*;

	#[derive(Wary)]
	#[wary(crate = "crate")]
	struct Version(#[validate(semver)] &'static str);

	#[test]
	fn test_semver_rule() {
		let version = Version("1.2.3");

		assert!(version.validate(&()).is_ok());

		let version = Version("1.2.3-alpha");

		assert!(version.validate(&()).is_ok());

		let version = Version("blah");

		assert!(version.validate(&()).is_err());
	}
}