Struct NetworkSnapshot 

#[non_exhaustive]
pub struct NetworkSnapshot {
    pub wifi: RadioState,
    pub wwan: RadioState,
    pub bluetooth: RadioState,
    pub airplane_mode: AirplaneModeState,
    pub connectivity: ConnectivityReport,
    pub active_connections: Vec<ActiveConnection>,
    pub access_points: Vec<AccessPoint>,
    pub saved_connections: Vec<SavedConnection>,
    pub saved_wifi_profiles: Vec<SavedConnection>,
    pub saved_vpn_profiles: Vec<SavedConnection>,
    pub wifi_devices: Vec<WifiDevice>,
    pub wired_devices: Vec<Device>,
}

Point-in-time state needed by GUI network applets.

Build this with NetworkManager::snapshot after receiving a NetworkEvent.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

wifi: RadioState

Wi-Fi radio state.

wwan: RadioState

WWAN/mobile broadband radio state.

bluetooth: RadioState

Bluetooth radio state.

airplane_mode: AirplaneModeState

Aggregated airplane-mode state.

connectivity: ConnectivityReport

Connectivity and captive-portal state.

active_connections: Vec<ActiveConnection>

Active connections classified for applet rendering.

access_points: Vec<AccessPoint>

Visible access points, one entry per BSSID.

saved_connections: Vec<SavedConnection>

All saved connection profiles.

saved_wifi_profiles: Vec<SavedConnection>

Saved Wi-Fi profiles.

saved_vpn_profiles: Vec<SavedConnection>

Saved VPN profiles, including kernel WireGuard profiles.

wifi_devices: Vec<WifiDevice>

Wi-Fi device summaries.

wired_devices: Vec<Device>

Wired Ethernet devices from the broad device model.

Implementations

impl NetworkSnapshot

pub fn wifi_groups(&self) -> Vec<WifiNetworkGroup>

Groups visible access points by (interface, ssid) for applet Wi-Fi rows.

Each group keeps every BSSID for advanced UI behavior and exposes the strongest AP as the representative row. Matching saved profiles are attached when their SSID, optional interface binding, and optional BSSID binding match the visible group.

pub fn known_wifi_by_ssid(&self) -> HashMap<String, Vec<SavedConnectionBrief>>

Returns saved Wi-Fi profiles keyed by SSID.

Duplicate profiles for the same SSID are preserved. Hidden profiles are included when their saved settings contain an SSID, even if no visible AP appears in this snapshot.

pub fn saved_vpn_map(&self) -> HashMap<String, SavedVpnSummary>

Returns saved VPN profiles keyed by UUID.

Both NetworkManager plugin VPNs and native WireGuard profiles are included. A summary is marked active when a typed active VPN connection has the same UUID.

pub fn applet_summary(&self) -> AppletNetworkSummary

Builds an applet-oriented summary from this snapshot.

This is equivalent to calling Self::wifi_groups, Self::known_wifi_by_ssid, and Self::saved_vpn_map on the same snapshot and bundling the results with active connection, connectivity, and airplane-mode state.

Trait Implementations

impl Clone for NetworkSnapshot

fn clone(&self) -> NetworkSnapshot

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NetworkSnapshot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.