age-setup 0.3.0

a rust library that creates X25519 key pairs and uses age as its foundation and is very easy to use
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

use crate::errors::{Error, Result, ValidationError};

/// Validates that a string has the standard age public key prefix.
///
/// Checks that `key` is non-empty and starts with `"age1"`. This function
/// is used internally by [`PublicKey::new`](crate::PublicKey::new).
///
/// # Errors
///
/// Returns [`Error::Validation`] with:
///
/// * [`ValidationError::InvalidPublicKeyFormat`](crate::ValidationError::InvalidPublicKeyFormat)
///   if the key is empty.
/// * [`ValidationError::InvalidPublicKeyFormat`](crate::ValidationError::InvalidPublicKeyFormat)
///   if the key does not start with `"age1"`. The error message includes the
///   first 10 characters of the offending input.
///
/// # Examples
///
/// ```rust
/// use age_setup::validation::validate_age_prefix;
///
/// assert!(validate_age_prefix("age1abc").is_ok());
/// assert!(validate_age_prefix("bad").is_err());
/// assert!(validate_age_prefix("").is_err());
/// ```
pub fn validate_age_prefix(key: &str) -> Result<()> {
    if key.is_empty() {
        return Err(Error::from(ValidationError::invalid_public_key(
            "Key is empty",
        )));
    }
    if !key.starts_with("age1") {
        return Err(Error::from(ValidationError::invalid_public_key(format!(
            "Key must start with 'age1', got: {}",
            &key[..key.len().min(10)]
        ))));
    }
    Ok(())
}

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

    #[test]
    fn empty() {
        let e = validate_age_prefix("").unwrap_err();
        assert!(matches!(e, Error::Validation(_)));
    }

    #[test]
    fn wrong_prefix() {
        let e = validate_age_prefix("xxx").unwrap_err();
        let msg = format!("{}", e);
        assert!(msg.contains("must start with 'age1'"));
    }

    #[test]
    fn valid() {
        assert!(validate_age_prefix("age1abc").is_ok());
    }
}