rusty-fez 0.5.0

Agent-native management CLI for Fedora/RHEL (drives cockpit-bridge)
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

//! Capability descriptors for `network` commands.

use super::{input, Descriptor};

/// Return descriptors for all `network.*` capabilities.
pub(super) fn descriptors() -> Vec<Descriptor> {
    vec![
        Descriptor {
            id: "network.list",
            summary: "List network devices",
            long: "List NetworkManager devices with their type, state, primary IPv4/IPv6 \
        address, and MAC. By default unmanaged virtual interfaces (container veth, etc.) are \
        hidden; use --all to show every device. Read-only.",
            privileged: false,
            output_kind: "NetworkDeviceList",
            inputs: vec![],
            flags: vec!["--host", "--json", "--all"],
            examples: vec![
                "fez network list --json".into(),
                "fez network list --all".into(),
            ],
        },
        Descriptor {
            id: "network.show",
            summary: "Show one device's network detail",
            long: "Show the full network detail for one device: addresses (IPv4 and IPv6), \
        gateway, DNS servers, search domains, routes, MAC, MTU, the active connection profile, \
        and DHCP lease. Read-only.",
            privileged: false,
            output_kind: "NetworkDeviceDetail",
            inputs: vec![input("device", true)],
            flags: vec!["--host", "--json"],
            examples: vec!["fez network show enp1s0 --json".into()],
        },
    ]
}

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

    #[test]
    fn network_descriptor_contract_stays_stable() {
        let descriptors = descriptors();
        let ids: Vec<&str> = descriptors.iter().map(|d| d.id).collect();
        assert_eq!(ids, ["network.list", "network.show"]);

        let list = &descriptors[0];
        assert_eq!(list.flags, ["--host", "--json", "--all"]);
        assert!(list.inputs.is_empty());

        let show = &descriptors[1];
        assert_eq!(show.flags, ["--host", "--json"]);
        assert_eq!(show.inputs.len(), 1);
        assert_eq!(show.inputs[0].name, "device");
        assert!(show.inputs[0].required);
    }
}