libvctrl_handler 5.2.0

Fundamental contracts for building a version control system – no implementations, only traits and types
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

use criterion as _;
use libvctrl_handler::{MAX_NAME_LENGTH, UserID, VctrlError};
mod common;

#[test]
fn test_user_id_valid() {
    let user = common::ok(UserID::new(
        "Alice".to_string(),
        "alice@example.com".to_string(),
    ));
    assert_eq!(user.name(), "Alice");
    assert_eq!(user.email(), "alice@example.com");
}

#[test]
fn test_user_id_invalid_empty_name() {
    let result = UserID::new(String::new(), "alice@example.com".to_string());
    assert!(result.is_err());
    assert_eq!(
        common::err(result),
        VctrlError::InvalidName("user name is empty".to_string())
    );
}

#[test]
fn test_user_id_invalid_name_too_long() {
    let max_len = usize::try_from(MAX_NAME_LENGTH).unwrap_or(usize::MAX);
    let name = "a".repeat(max_len + 1);
    let result = UserID::new(name, "alice@example.com".to_string());
    assert!(result.is_err());
    assert_eq!(
        common::err(result),
        VctrlError::InvalidName(format!(
            "user name exceeds maximum length {MAX_NAME_LENGTH}"
        ))
    );
}

#[test]
fn test_user_id_invalid_name_control_chars() {
    let name = "Alice\nBob".to_string();
    let result = UserID::new(name.clone(), "alice@example.com".to_string());
    assert!(result.is_err());
    assert_eq!(
        common::err(result),
        VctrlError::InvalidName(format!("user name contains control characters: '{name}'"))
    );
}

#[test]
fn test_user_id_invalid_empty_email() {
    let result = UserID::new("Alice".to_string(), String::new());
    assert!(result.is_err());
    assert_eq!(
        common::err(result),
        VctrlError::InvalidEmail("email is empty".to_string())
    );
}

#[test]
fn test_user_id_invalid_email_no_at() {
    let email = "alice.example.com".to_string();
    let result = UserID::new("Alice".to_string(), email.clone());
    assert!(result.is_err());
    assert_eq!(
        common::err(result),
        VctrlError::InvalidEmail(format!("email must contain '@': '{email}'"))
    );
}

#[test]
fn test_user_id_invalid_email_too_long() {
    let max_len = usize::try_from(MAX_NAME_LENGTH).unwrap_or(usize::MAX);
    let email = format!("{}@example.com", "a".repeat(max_len + 1));
    let result = UserID::new("Alice".to_string(), email);
    assert!(result.is_err());
    assert_eq!(
        common::err(result),
        VctrlError::InvalidEmail(format!("email exceeds maximum length {MAX_NAME_LENGTH}"))
    );
}

#[test]
fn test_user_id_invalid_email_control_chars() {
    let email = "alice@example.com\n".to_string();
    let result = UserID::new("Alice".to_string(), email.clone());
    assert!(result.is_err());
    assert_eq!(
        common::err(result),
        VctrlError::InvalidEmail(format!("email contains control characters: '{email}'"))
    );
}