chore!: drop GUI (#39)

* chore!: drop GUI

* 📝 Add docstrings to `drop_gui` (#40)

Docstrings generation was requested by @JarbasAl.

* #39 (comment)

The following files were modified:

* `ovos_PHAL_plugin_network_manager/__init__.py`

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: JarbasAl

README.md

@@ -8,8 +8,6 @@ The dbus interface for this plugin is a work in progress. [#15](https://github.c
 This plugin has the following requirements:
 - nmcli
 
-It also provides a GUI interface to setup wifi on screen, in this case you also need:
-- Plasma Network Manager: https://invent.kde.org/plasma/plasma-nm
 
 # Install
 

ovos_PHAL_plugin_network_manager/__init__.py

@@ -5,7 +5,7 @@
 from ovos_config import Configuration
 from ovos_plugin_manager.templates.phal import AdminPlugin, AdminValidator, PHALPlugin, PHALValidator
 from ovos_utils.log import LOG
-from ovos_PHAL_plugin_network_manager.gui import GUISetup
+
 
 # Event Documentation
 # ===================
@@ -77,6 +77,15 @@ class NetworkManagerPlugin(PHALPlugin):
     validator = NetworkManagerValidator
 
     def __init__(self, bus=None, config=None):
+        """
+        Initialize the NetworkManagerPlugin and register PHAL network event handlers on the message bus.
+        
+        Registers handlers for network manager events such as scanning, connecting (including open networks), reconnecting, disconnecting, forgetting networks, and querying the currently connected network.
+        
+        Parameters:
+            bus: Message bus instance used to subscribe to PHAL events.
+            config: Optional configuration dictionary or object for plugin initialization.
+        """
         super().__init__(bus=bus, name="ovos-PHAL-plugin-network-manager", config=config)
         # Register Network Manager Events
         self.bus.on("ovos.phal.nm.scan", self.handle_network_scan_request)
@@ -86,11 +95,20 @@ def __init__(self, bus=None, config=None):
         self.bus.on("ovos.phal.nm.disconnect", self.handle_network_disconnect_request)
         self.bus.on("ovos.phal.nm.forget", self.handle_network_forget_request)
         self.bus.on("ovos.phal.nm.get.connected", self.handle_network_connected_query)
-        self.gui_setup = GUISetup(bus=bus)  # extra GUI events
 
     # Network Manager Events
     def handle_network_scan_request(self, message):
         # Scan for networks using Network Manager and build a list of networks found and their security types
+        """
+        Scan for available Wi-Fi networks using Network Manager and emit a completion message with results.
+        
+        Performs an nmcli rescan and lists SSID and SECURITY fields, then emits an "ovos.phal.nm.scan.complete" Message on the bus with a payload containing a "networks" list. Each list item is a dict with keys:
+        - "ssid": network SSID string
+        - "security": security string reported by nmcli
+        
+        Parameters:
+            message (Message): Incoming request message (contents are not inspected).
+        """
         LOG.info("Scanning for networks using nmcli backend")
         subprocess.Popen(
             ['nmcli', 'dev', 'wifi', 'rescan']