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

use crate::newtypes::libcnb_newtype;

libcnb_newtype!(
    buildpack,
    /// Construct a [`StackId`] value at compile time.
    ///
    /// Passing a string that is not a valid `StackId` value will yield a compilation error.
    ///
    /// # Examples:
    /// ```
    /// use libcnb_data::stack_id;
    /// use libcnb_data::buildpack::StackId;
    ///
    /// let stack_id: StackId = stack_id!("heroku-20");
    /// ```
    stack_id,
    /// The ID of a stack.
    ///
    /// It MUST only contain numbers, letters, and the characters `.`, `/`, and `-`.
    ///
    /// Use the [`stack_id`](crate::stack_id) macro to construct a `StackId` from a
    /// literal string. To parse a dynamic string into a `StackId`, use
    /// [`str::parse`](str::parse).
    ///
    /// # Examples
    /// ```
    /// use libcnb_data::buildpack::StackId;
    /// use libcnb_data::stack_id;
    ///
    /// let from_literal = stack_id!("heroku-20");
    ///
    /// let input = "heroku-20";
    /// let from_dynamic: StackId = input.parse().unwrap();
    /// assert_eq!(from_dynamic, from_literal);
    ///
    /// let input = "_stack_";
    /// let invalid: Result<StackId, _> = input.parse();
    /// assert!(invalid.is_err());
    /// ```
    StackId,
    StackIdError,
    r"^[[:alnum:]./-]+$"
);

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

    #[test]
    fn stack_id_validation_valid() {
        assert!("heroku-20".parse::<StackId>().is_ok());
        assert!("Abc123./-".parse::<StackId>().is_ok());
    }

    #[test]
    fn stack_id_validation_invalid() {
        assert_eq!(
            "heroku_20".parse::<StackId>(),
            Err(StackIdError::InvalidValue(String::from("heroku_20")))
        );
        assert_eq!(
            "heroku:20".parse::<StackId>(),
            Err(StackIdError::InvalidValue(String::from("heroku:20")))
        );
        assert_eq!(
            "heroku 20".parse::<StackId>(),
            Err(StackIdError::InvalidValue(String::from("heroku 20")))
        );
        assert_eq!(
            "".parse::<StackId>(),
            Err(StackIdError::InvalidValue(String::new()))
        );
    }
}