envbind 0.1.0

Typed environment binding primitives for Rust services.
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
105
106

#![allow(missing_docs)]

use envbind::{BindError, EnvironmentError, ValidationError};

#[test]
fn validation_error_keeps_message() {
    let error = ValidationError::new("bad value");

    assert_eq!(error.message(), "bad value");
}

#[test]
fn missing_error_has_stable_code() {
    let error = BindError::missing("PORT");

    assert_eq!(error.error_code(), "missing_variable");
}

#[test]
fn empty_error_has_stable_code() {
    let error = BindError::empty("PORT");

    assert_eq!(error.error_code(), "empty_variable");
}

#[test]
fn environment_error_has_stable_code() {
    let error = BindError::environment("PORT", EnvironmentError::not_unicode());

    assert_eq!(error.error_code(), "environment_error");
}

#[test]
fn invalid_boolean_error_has_stable_code() {
    let error = BindError::invalid_boolean("TLS");

    assert_eq!(error.error_code(), "invalid_boolean");
}

#[test]
fn parse_error_has_stable_code() {
    let error = BindError::parse("PORT", "u16");

    assert_eq!(error.error_code(), "parse_variable");
}

#[test]
fn validation_error_has_stable_code() {
    let error = BindError::validation("PORT", ValidationError::new("range"));

    assert_eq!(error.error_code(), "validation_failed");
}

#[test]
fn value_too_large_error_has_stable_code() {
    let error = BindError::value_too_large("TOKEN", 8);

    assert_eq!(error.error_code(), "value_too_large");
}

#[test]
fn bind_error_display_includes_variable_and_context() {
    let error = BindError::parse("PORT", "u16");

    assert_eq!(
        error.to_string(),
        "environment variable PORT must parse as u16"
    );
}

#[test]
fn bind_error_display_redacts_raw_values() {
    let error = BindError::invalid_boolean("TOKEN_MODE");

    assert!(!error.to_string().contains("secret-value"));
}

#[test]
fn invalid_boolean_display_is_safe() {
    let error = BindError::invalid_boolean("TOKEN_MODE");

    assert_eq!(
        error.to_string(),
        "environment variable TOKEN_MODE must be boolean-like"
    );
}

#[test]
fn environment_error_display_is_safe() {
    let error = BindError::environment("TOKEN", EnvironmentError::not_unicode());

    assert_eq!(
        error.to_string(),
        "environment variable TOKEN read failed: value is not valid Unicode"
    );
}

#[test]
fn environment_read_error_display_redacts_adapter_message() {
    let error = BindError::environment("TOKEN", EnvironmentError::read("secret-value"));

    assert_eq!(
        error.to_string(),
        "environment variable TOKEN read failed: adapter read failed"
    );
}