nm-wifi 0.3.0

A Terminal User Interface for managing Wi-Fi connections on Linux
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

use nm_wifi::{
    app_state::{App, AppState},
    ui::{format_ssid_column, get_frequency_band, keybindings_hint, ui},
    wifi::{WifiNetwork, WifiSecurity},
};
use ratatui::{Terminal, backend::TestBackend};

fn network(ssid: &str, security: WifiSecurity, connected: bool) -> WifiNetwork {
    WifiNetwork {
        ssid: ssid.to_string(),
        signal_strength: 78,
        security,
        frequency: 5180,
        connected,
    }
}

#[test]
fn types_selection_stays_in_sync_in_integration_tests() {
    let mut app = App::new();
    app.state = AppState::NetworkList;
    app.networks = vec![
        network("guest", WifiSecurity::Open, false),
        network("home", WifiSecurity::WpaPsk, true),
    ];

    app.next();
    assert_eq!(app.selected_index, 1);

    app.previous();
    assert_eq!(app.selected_index, 0);
}

#[test]
fn ui_renderer_draws_network_list_screen() {
    let backend = TestBackend::new(80, 24);
    let mut terminal = Terminal::new(backend).expect("terminal created");
    let mut app = App::new();
    app.state = AppState::NetworkList;
    app.networks = vec![network("CatCat", WifiSecurity::WpaSae, true)];
    app.network_count = app.networks.len();
    app.adapter_name = Some("demo-wlan0".to_string());

    terminal
        .draw(|frame| ui(frame, &app))
        .expect("render succeeds");

    let buffer = terminal.backend().buffer().clone();
    let mut text = String::new();
    for y in 0..buffer.area.height {
        for x in 0..buffer.area.width {
            text.push_str(buffer[(x, y)].symbol());
        }
        text.push('\n');
    }

    assert!(text.contains("WiFi Networks"));
    assert!(text.contains("demo-wlan0"));
}

#[test]
fn public_ui_helpers_remain_usable_from_integration_tests() {
    assert_eq!(get_frequency_band(2412), "2.4G");
    assert_eq!(get_frequency_band(5180), "5G");
    assert_eq!(keybindings_hint(&AppState::Help), "h/q/Esc Back");
    assert_eq!(format_ssid_column("abc", 5), "abc  ");
}

#[cfg(feature = "demo")]
#[tokio::test]
async fn demo_network_module_scans_and_connects_in_integration_tests() {
    use nm_wifi::{
        backend::{DemoNetworkBackend, NetworkBackend},
        network::{ConnectionRequest, demo_networks},
    };

    let backend = DemoNetworkBackend;
    let networks = backend.scan_networks().await.expect("demo scan succeeds");
    assert!(networks.iter().any(|network| network.ssid == "CatCat"));
    assert_eq!(
        backend.adapter_name().expect("adapter query succeeds"),
        Some("demo-wlan0".to_string())
    );

    let network = demo_networks()
        .into_iter()
        .find(|network| network.security == WifiSecurity::WpaSae)
        .expect("demo WPA3 network exists");

    backend
        .connect(ConnectionRequest::Secured {
            network: &network,
            passphrase: "AcerolaAcai",
        })
        .expect("demo connect succeeds");
}