nm-wifi 0.2.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

use std::{error::Error, future::Future, pin::Pin};

use crate::{network::ConnectionRequest, wifi::WifiNetwork};

pub type BackendFuture<'a, T> = Pin<Box<dyn Future<Output = T> + 'a>>;

pub trait NetworkBackend {
    fn connected_ssid(&self) -> Result<Option<String>, Box<dyn Error>>;
    fn adapter_name(&self) -> Result<Option<String>, Box<dyn Error>>;
    fn scan_networks(
        &self,
    ) -> BackendFuture<'_, Result<Vec<WifiNetwork>, Box<dyn Error>>>;
    fn connect(
        &self,
        request: ConnectionRequest<'_>,
    ) -> Result<(), Box<dyn Error>>;
    fn disconnect(&self, network: &WifiNetwork) -> Result<(), Box<dyn Error>>;
}

#[cfg(feature = "demo")]
#[derive(Debug, Default, Clone, Copy)]
pub struct DemoNetworkBackend;

#[cfg(feature = "demo")]
impl NetworkBackend for DemoNetworkBackend {
    fn connected_ssid(&self) -> Result<Option<String>, Box<dyn Error>> {
        crate::network::demo::get_connected_ssid()
    }

    fn adapter_name(&self) -> Result<Option<String>, Box<dyn Error>> {
        crate::network::demo::get_wifi_adapter_name()
    }

    fn scan_networks(
        &self,
    ) -> BackendFuture<'_, Result<Vec<WifiNetwork>, Box<dyn Error>>> {
        Box::pin(crate::network::demo::scan_wifi_networks())
    }

    fn connect(
        &self,
        request: ConnectionRequest<'_>,
    ) -> Result<(), Box<dyn Error>> {
        crate::network::demo::connect_to_network(request)
    }

    fn disconnect(&self, network: &WifiNetwork) -> Result<(), Box<dyn Error>> {
        crate::network::demo::disconnect_from_network(network)
    }
}

#[cfg(not(feature = "demo"))]
#[derive(Debug, Default, Clone, Copy)]
pub struct NetworkManagerBackend;

#[cfg(not(feature = "demo"))]
impl NetworkBackend for NetworkManagerBackend {
    fn connected_ssid(&self) -> Result<Option<String>, Box<dyn Error>> {
        crate::network::networkmanager::get_connected_ssid()
    }

    fn adapter_name(&self) -> Result<Option<String>, Box<dyn Error>> {
        crate::network::networkmanager::get_wifi_adapter_name()
    }

    fn scan_networks(
        &self,
    ) -> BackendFuture<'_, Result<Vec<WifiNetwork>, Box<dyn Error>>> {
        Box::pin(crate::network::networkmanager::scan_wifi_networks())
    }

    fn connect(
        &self,
        request: ConnectionRequest<'_>,
    ) -> Result<(), Box<dyn Error>> {
        crate::network::networkmanager::connect_to_network(request)
    }

    fn disconnect(&self, network: &WifiNetwork) -> Result<(), Box<dyn Error>> {
        crate::network::networkmanager::disconnect_from_network(network)
    }
}

#[cfg(feature = "demo")]
pub fn default_backend() -> Box<dyn NetworkBackend> {
    Box::new(DemoNetworkBackend)
}

#[cfg(not(feature = "demo"))]
pub fn default_backend() -> Box<dyn NetworkBackend> {
    Box::new(NetworkManagerBackend)
}