mountos-admin-sdk 1.19.0

Rust SDK for the mountOS provider API
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

//! Regression coverage for the generated closed wire-enum types (gen/rustgen.go
//! writeRustEnum): a known value must deserialize to its own variant, an
//! unrecognized value must deserialize to the fallback variant carrying the
//! original string rather than a hard parse failure, and the round trip back
//! to JSON must reproduce the original wire string.

use mountos_admin_sdk::{ClientSessionStatus, CopysetState};

#[test]
fn copyset_state_deserializes_known_values() {
    for (wire, want) in [
        ("active", CopysetState::Active),
        ("draining", CopysetState::Draining),
        ("synced_drained", CopysetState::SyncedDrained),
        ("retired", CopysetState::Retired),
    ] {
        let json = format!("\"{wire}\"");
        let got: CopysetState = serde_json::from_str(&json).expect("deserialize known value");
        assert_eq!(got, want, "wire value {wire:?}");
        assert!(got.is_known());
        assert_eq!(got.as_str(), wire);
    }
}

#[test]
fn copyset_state_deserializes_unknown_value_to_fallback() {
    let got: CopysetState = serde_json::from_str("\"future_state\"").expect("deserialize unknown value");
    assert_eq!(got, CopysetState::Unknown("future_state".to_string()));
    assert!(!got.is_known());
    assert_eq!(got.as_str(), "future_state");
}

#[test]
fn copyset_state_serialize_round_trips_known_and_unknown() {
    let known = CopysetState::Draining;
    assert_eq!(serde_json::to_string(&known).unwrap(), "\"draining\"");

    let unknown = CopysetState::Unknown("future_state".to_string());
    assert_eq!(serde_json::to_string(&unknown).unwrap(), "\"future_state\"");
}

#[test]
fn copyset_state_display_matches_as_str() {
    assert_eq!(CopysetState::Retired.to_string(), "retired");
    assert_eq!(CopysetState::Unknown("x".to_string()).to_string(), "x");
}

// ClientSessionStatus has a legitimate wire value literally named "unknown"
// (see api.yaml), which is exactly why the generator's fallback variant is
// named UnknownValue instead of Unknown for this enum - this test guards
// that collision-avoidance, not just the general enum shape covered above.
#[test]
fn client_session_status_unknown_value_is_the_declared_variant_not_the_fallback() {
    let got: ClientSessionStatus = serde_json::from_str("\"unknown\"").expect("deserialize");
    assert_eq!(got, ClientSessionStatus::Unknown);
    assert!(got.is_known());
}

#[test]
fn client_session_status_deserializes_unrecognized_value_to_fallback() {
    let got: ClientSessionStatus =
        serde_json::from_str("\"totally_new_status\"").expect("deserialize unrecognized value");
    assert_eq!(got, ClientSessionStatus::UnknownValue("totally_new_status".to_string()));
    assert!(!got.is_known());
}