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

#![allow(missing_docs)]

use envbind::{Binder, BoolVar, MapEnvironment, ValidationError};

#[test]
fn bool_var_reads_truthy_value() {
    let value =
        Binder::new(MapEnvironment::from_pairs([("TLS", "yes")])).bind(&BoolVar::new("TLS"));

    assert_eq!(value, Ok(true));
}

#[test]
fn bool_var_reads_falsy_value() {
    let value =
        Binder::new(MapEnvironment::from_pairs([("TLS", "off")])).bind(&BoolVar::new("TLS"));

    assert_eq!(value, Ok(false));
}

#[test]
fn bool_var_uses_default_when_missing() {
    let value = Binder::new(MapEnvironment::new()).bind(&BoolVar::new("TLS").default(true));

    assert_eq!(value, Ok(true));
}

#[test]
fn bool_var_rejects_missing_value_without_default() {
    let value = Binder::new(MapEnvironment::new())
        .bind(&BoolVar::new("TLS"))
        .map_err(|error| error.error_code());

    assert_eq!(value, Err("missing_variable"));
}

#[test]
fn bool_var_rejects_empty_value() {
    let value = Binder::new(MapEnvironment::from_pairs([("TLS", "")]))
        .bind(&BoolVar::new("TLS"))
        .map_err(|error| error.error_code());

    assert_eq!(value, Err("empty_variable"));
}

#[test]
fn bool_var_rejects_whitespace_as_invalid_text() {
    let value = Binder::new(MapEnvironment::from_pairs([("TLS", " ")]))
        .bind(&BoolVar::new("TLS"))
        .map_err(|error| error.error_code());

    assert_eq!(value, Err("invalid_boolean"));
}

#[test]
fn bool_var_rejects_invalid_text() {
    let value = Binder::new(MapEnvironment::from_pairs([("TLS", "maybe")]))
        .bind(&BoolVar::new("TLS"))
        .map_err(|error| error.error_code());

    assert_eq!(value, Err("invalid_boolean"));
}

#[test]
fn bool_var_runs_validator() {
    let value = Binder::new(MapEnvironment::from_pairs([("TLS", "false")]))
        .bind(&BoolVar::new("TLS").sensitive(false).validate(|enabled| {
            if enabled {
                Ok(())
            } else {
                Err(ValidationError::new("TLS must be enabled"))
            }
        }))
        .map_err(|error| {
            (
                error.error_code().to_owned(),
                error.to_string().contains("TLS must be enabled"),
            )
        });

    assert_eq!(value, Err(("validation_failed".to_owned(), true)));
}

#[test]
fn bool_var_skips_validation_for_default_value() {
    let value = Binder::new(MapEnvironment::new()).bind(
        &BoolVar::new("TLS").default(false).validate(|enabled| {
            if enabled {
                Ok(())
            } else {
                Err(ValidationError::new("TLS must be enabled"))
            }
        }),
    );

    assert_eq!(value, Ok(false));
}