Get Sound Devices Report (Python)

#!/usr/bin/env python3
"""
get_sound_device_report.py

Reports Sound Devices on this computer via WMI (Win32_SoundDevice), using the
built-in `wmic` command so no extra packages are required.

Usage:
    python get_sound_device_report.py
"""

import csv
import io
import subprocess
import sys


def main() -> None:
    result = subprocess.run(
        ["wmic", "path", "Win32_SoundDevice", "get", "Name,Manufacturer,Status", "/format:csv"],
        capture_output=True, text=True, check=False,
    )

    if result.returncode != 0:
        sys.exit(f"wmic failed: {result.stderr.strip()}")

    lines = [line for line in result.stdout.splitlines() if line.strip()]
    if len(lines) < 2:
        print("No Sound Devices found.")
        return

    reader = csv.DictReader(io.StringIO("\n".join(lines)))
    rows = list(reader)

    for row in rows:
        for key, value in row.items():
            if key and key != "Node":
                print(f"  {key}: {value}")
        print("-" * 40)

    print(f"\n{len(rows)} Sound Devices found.")


if __name__ == "__main__":
    main()