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

use crate::newtypes::libcnb_newtype;

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

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

    #[test]
    fn buildpack_id_validation_valid() {
        assert!("heroku/jvm".parse::<BuildpackId>().is_ok());
        assert!("Abc123./-".parse::<BuildpackId>().is_ok());
        assert!("app-foo".parse::<BuildpackId>().is_ok());
        assert!("foo-app".parse::<BuildpackId>().is_ok());
    }

    #[test]
    fn buildpack_id_validation_invalid() {
        assert_eq!(
            "heroku_jvm".parse::<BuildpackId>(),
            Err(BuildpackIdError::InvalidValue(String::from("heroku_jvm")))
        );
        assert_eq!(
            "heroku:jvm".parse::<BuildpackId>(),
            Err(BuildpackIdError::InvalidValue(String::from("heroku:jvm")))
        );
        assert_eq!(
            "heroku jvm".parse::<BuildpackId>(),
            Err(BuildpackIdError::InvalidValue(String::from("heroku jvm")))
        );
        assert_eq!(
            "app".parse::<BuildpackId>(),
            Err(BuildpackIdError::InvalidValue(String::from("app")))
        );
        assert_eq!(
            "config".parse::<BuildpackId>(),
            Err(BuildpackIdError::InvalidValue(String::from("config")))
        );
        assert_eq!(
            "".parse::<BuildpackId>(),
            Err(BuildpackIdError::InvalidValue(String::new()))
        );
    }
}