Update docstubs stubs for stable

Author: Josverl

stubs/micropython-v1_26_1-docstubs/network/WLAN.pyi

@@ -2,19 +2,16 @@
 
 from __future__ import annotations
 from _typeshed import Incomplete
-from typing import overload, Any, List, Tuple
+from typing import Any, List, Optional, Tuple
 from typing_extensions import TypeVar, TypeAlias, Awaitable
 
 class WLAN:
     """
-    This class provides a driver for WiFi network processors.  Example usage::
-
-        import network
-        # enable station interface and connect to WiFi access point
-        nic = network.WLAN(network.STA_IF)
-        nic.active(True)
-        nic.connect('your-ssid', 'your-password')
-        # now use sockets as usual
+    Create a WLAN network interface object. Supported interfaces are
+    ``network.WLAN.IF_STA`` (station aka client, connects to upstream WiFi access
+    points) and ``network.WLAN.IF_AP`` (access point, allows other WiFi clients to
+    connect). Availability of the methods below depends on interface type.
+    For example, only STA interface may `WLAN.connect()` to an access point.
     """
 
     PM_PERFORMANCE: Incomplete
@@ -30,40 +27,15 @@ class WLAN:
     savings and reduced WiFi performance
     * ``PM_NONE``: disable wifi power management
     """
-    PM_NONE: int
-    PM_POWERSAVE: int
-    def __init__(self, interface_id: int = ..., /) -> None:
-        """
-        Create a WLAN network interface object. Supported interfaces are
-        ``network.STA_IF`` (station aka client, connects to upstream WiFi access
-        points) and ``network.AP_IF`` (access point, allows other WiFi clients to
-        connect). Availability of the methods below depends on interface type.
-        For example, only STA interface may `WLAN.connect()` to an access point.
-        """
-
-    @overload
-    def active(self, /) -> bool:
+    def __init__(self, interface_id) -> None: ...
+    def active(self, is_active: Optional[Any] = None) -> None:
         """
         Activate ("up") or deactivate ("down") network interface, if boolean
         argument is passed. Otherwise, query current state if no argument is
         provided. Most other methods require active interface.
         """
-
-    @overload
-    def active(self, is_active: bool | int, /) -> None:
-        """
-        Activate ("up") or deactivate ("down") network interface, if boolean
-        argument is passed. Otherwise, query current state if no argument is
-        provided. Most other methods require active interface.
-        """
-    def connect(
-        self,
-        ssid: str | None = None,
-        password: str | None = None,
-        /,
-        *,
-        bssid: bytes | None = None,
-    ) -> None:
+        ...
+    def connect(self, ssid=None, key=None, *, bssid=None) -> None:
         """
         Connect to the specified wireless network, using the specified key.
         If *bssid* is given then the connection will be restricted to the
@@ -104,39 +76,7 @@ class WLAN:
             * 1 -- hidden
         """
         ...
-
-    @overload
-    def status(self) -> int:
-        """
-        Return the current status of the wireless connection.
-
-        When called with no argument the return value describes the network link status.
-        The possible statuses are defined as constants in the :mod:`network` module:
-
-            * ``STAT_IDLE`` -- no connection and no activity,
-            * ``STAT_CONNECTING`` -- connecting in progress,
-            * ``STAT_WRONG_PASSWORD`` -- failed due to incorrect password,
-            * ``STAT_NO_AP_FOUND`` -- failed because no access point replied,
-            * ``STAT_CONNECT_FAIL`` -- failed due to other problems,
-            * ``STAT_GOT_IP`` -- connection successful.
-
-        When called with one argument *param* should be a string naming the status
-        parameter to retrieve, and different parameters are supported depending on the
-        mode the WiFi is in.
-
-        In STA mode, passing ``'rssi'`` returns a signal strength indicator value, whose
-        format varies depending on the port (this is available on all ports that support
-        WiFi network interfaces, except for CC3200).
-
-        In AP mode, passing ``'stations'`` returns a list of connected WiFi stations
-        (this is available on all ports that support WiFi network interfaces, except for
-        CC3200).  The format of the station information entries varies across ports,
-        providing either the raw BSSID of the connected station, the IP address of the
-        connected station, or both.
-        """
-
-    @overload
-    def status(self, param: str, /) -> int:
+    def status(self, param: Optional[Any] = None) -> List[int]:
         """
         Return the current status of the wireless connection.
 
@@ -164,16 +104,15 @@ class WLAN:
         providing either the raw BSSID of the connected station, the IP address of the
         connected station, or both.
         """
+        ...
     def isconnected(self) -> bool:
         """
         In case of STA mode, returns ``True`` if connected to a WiFi access
         point and has a valid IP address.  In AP mode returns ``True`` when a
         station is connected. Returns ``False`` otherwise.
         """
         ...
-
-    @overload
-    def ifconfig(self) -> tuple[str, str, str, str]:
+    def ifconfig(self, configtuple: Optional[Any] = None) -> Tuple:
         """
         Get/set IP-level network interface parameters: IP address, subnet mask,
         gateway and DNS server. When called with no arguments, this method returns
@@ -182,55 +121,8 @@ class WLAN:
 
          nic.ifconfig(('192.168.0.4', '255.255.255.0', '192.168.0.1', '8.8.8.8'))
         """
-
-    @overload
-    def ifconfig(self, ip_mask_gateway_dns: tuple[str, str, str, str], /) -> None:
-        """
-        Get/set IP-level network interface parameters: IP address, subnet mask,
-        gateway and DNS server. When called with no arguments, this method returns
-        a 4-tuple with the above information. To set the above values, pass a
-        4-tuple with the required information.  For example::
-
-         nic.ifconfig(('192.168.0.4', '255.255.255.0', '192.168.0.1', '8.8.8.8'))
-        """
-
-    @overload
-    def config(self, param: str, /) -> Any:
-        """
-        Get or set general network interface parameters. These methods allow to work
-        with additional parameters beyond standard IP configuration (as dealt with by
-        `AbstractNIC.ipconfig()`). These include network-specific and hardware-specific
-        parameters. For setting parameters, keyword argument syntax should be used,
-        multiple parameters can be set at once. For querying, parameters name should
-        be quoted as a string, and only one parameter can be queries at time::
-
-         # Set WiFi access point name (formally known as SSID) and WiFi channel
-         ap.config(ssid='My AP', channel=11)
-         # Query params one by one
-         print(ap.config('ssid'))
-         print(ap.config('channel'))
-
-        Following are commonly supported parameters (availability of a specific parameter
-        depends on network technology type, driver, and :term:`MicroPython port`).
-
-        =============  ===========
-        Parameter      Description
-        =============  ===========
-        mac            MAC address (bytes)
-        ssid           WiFi access point name (string)
-        channel        WiFi channel (integer). Depending on the port this may only be supported on the AP interface.
-        hidden         Whether SSID is hidden (boolean)
-        security       Security protocol supported (enumeration, see module constants)
-        key            Access key (string)
-        hostname       The hostname that will be sent to DHCP (STA interfaces) and mDNS (if supported, both STA and AP). (Deprecated, use :func:`network.hostname` instead)
-        reconnects     Number of reconnect attempts to make (integer, 0=none, -1=unlimited)
-        txpower        Maximum transmit power in dBm (integer or float)
-        pm             WiFi Power Management setting (see below for allowed values)
-        =============  ===========
-        """
-
-    @overload
-    def config(self, **kwargs: Any) -> None:
+        ...
+    def config(self, *args, **kwargs) -> Incomplete:
         """
         Get or set general network interface parameters. These methods allow to work
         with additional parameters beyond standard IP configuration (as dealt with by
@@ -263,3 +155,4 @@ class WLAN:
         pm             WiFi Power Management setting (see below for allowed values)
         =============  ===========
         """
+        ...