Function gather_wifi_interfaces

wifi_interfaces.py:148–249

Collect Wi-Fi interface metadata using nmcli + ip link fallbacks.

(default_interface: str = 'wlan0')

def gather_wifi_interfaces(default_interface: str = 'wlan0') -> List[Dict]:
    """Collect Wi-Fi interface metadata using nmcli + ip link fallbacks."""
    # Resolve 'auto' to actual interface name
    if default_interface == 'auto':
        from shared import detect_wifi_interface
        default_interface = detect_wifi_interface('auto')
    interfaces: Dict[str, Dict] = {}

    try:
        nmcli_result = subprocess.run(
            ['nmcli', '-t', '-f', 'DEVICE,TYPE,STATE,CONNECTION', 'dev', 'status'],
            capture_output=True,
            text=True,
            timeout=5
        )
        if nmcli_result.returncode == 0:
            for line in nmcli_result.stdout.strip().split('\n'):
                if not line:
                    continue
                parts = line.split(':', 3)
                if len(parts) < 4:
                    continue
                device, dev_type, state, connection = parts
                if dev_type != 'wifi':
                    continue
                normalized_connection = connection if connection and connection != '--' else None
                interfaces[device] = {
                    'name': device,
                    'state': state or 'UNKNOWN',
                    'is_default': device == default_interface,
                    'connected_ssid': normalized_connection,
                    'connection': normalized_connection,
                    'connected': (state or '').lower() == 'connected' and bool(normalized_connection),
                }
    except Exception as exc:
        logger.debug(f"nmcli dev status failed: {exc}")

    try:
        ip_result = subprocess.run(
            ['ip', '-o', 'link', 'show'],
            capture_output=True,
            text=True,
            timeout=5
        )
        if ip_result.returncode == 0:
            for line in ip_result.stdout.strip().split('\n'):
                if not line:
                    continue
                name_match = re.match(r'\d+:\s+(\S+):', line)
                if not name_match:
                    continue
                iface_name = name_match.group(1)
                if not _WIFI_NAME_PATTERN.match(iface_name):
                    continue
                entry = interfaces.setdefault(iface_name, {
                    'name': iface_name,
                    'state': 'UNKNOWN',
                    'is_default': iface_name == default_interface,