python-netgear-switch-library 0.0.post341__tar.gz → 0.0.post342__tar.gz

{python_netgear_switch_library-0.0.post341 → python_netgear_switch_library-0.0.post342}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-netgear-switch-library
-Version: 0.0.post341
+Version: 0.0.post342
 Summary: Python library and CLI to query and control Netgear switches over SNMP, NSDP and HTTP.
 Author-email: Tim Ansell <me@mith.ro>
 License-Expression: Apache-2.0

{python_netgear_switch_library-0.0.post341 → python_netgear_switch_library-0.0.post342}/src/netgear_switch/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.0.post341'
-__version_tuple__ = version_tuple = (0, 0, 'post341')
+__version__ = version = '0.0.post342'
+__version_tuple__ = version_tuple = (0, 0, 'post342')
 
 __commit_id__ = commit_id = None

{python_netgear_switch_library-0.0.post341 → python_netgear_switch_library-0.0.post342}/src/netgear_switch/aio_api.py

@@ -645,6 +645,16 @@ class AsyncSwitch:
             lambda w: w.clear_poe_fault(port, force=force, timeouts=timeouts), backend
         )
 
+    async def set_hostname(
+        self, name: str, *, force: bool = False, backend: Backend | None = None
+    ) -> None:
+        """Async twin of ``SyncSwitch.set_hostname`` -- see there.
+
+        Note AsyncSwitch has no CLI backend at all, so on this facade the write
+        resolves over SNMP or not at all.
+        """
+        await self._write(lambda w: w.set_hostname(name, force=force), backend)
+
     async def set_mgmt_ip(
         self,
         address: str,

{python_netgear_switch_library-0.0.post341 → python_netgear_switch_library-0.0.post342}/src/netgear_switch/capabilities.py

@@ -149,6 +149,21 @@ WRITE_OPERATIONS: tuple[Operation, ...] = (
     Operation("create_vlan", OperationKind.WRITE, "Create a VLAN"),
     Operation("delete_vlan", OperationKind.WRITE, "Delete a VLAN"),
     Operation("set_mgmt_ip", OperationKind.WRITE, "Set the management IP/mask/gateway"),
+    Operation(
+        "set_hostname",
+        OperationKind.WRITE,
+        "Set the switch's host name",
+        # SNMP (sysName, confirmed writable on all five reachable switches) and
+        # the FASTPATH CLI (`hostname`) are what the library writes today.
+        #
+        # This restriction makes a REAL GAP visible rather than hiding it: the
+        # Plus models have neither backend, so this library currently cannot
+        # rename a gs110emx, gs105pe or gs305ep at all. Both routes exist on the
+        # devices -- NSDP carries a writable HOSTNAME tag and two web UIs expose
+        # a switch_name field -- so this is unbuilt work, not a device limit,
+        # and the support table should show the hole until it is filled.
+        backends=frozenset({Backend.SNMP}) | _CLI_BACKENDS,
+    ),
     Operation(
         "upload_certificate",
         OperationKind.WRITE,

{python_netgear_switch_library-0.0.post341 → python_netgear_switch_library-0.0.post342}/src/netgear_switch/sync_api.py

@@ -795,6 +795,21 @@ class SyncSwitch:
             lambda w: w.clear_poe_fault(port, force=force, timeouts=timeouts), backend
         )
 
+    def set_hostname(
+        self, name: str, *, force: bool = False, backend: Backend | None = None
+    ) -> None:
+        """Set the switch's host name, and read it back to confirm.
+
+        Written over SNMP (``sysName``) or the FASTPATH CLI (``hostname``),
+        whichever backend resolves. Not force-gated: renaming cannot strand a
+        switch and is reversible by writing the old name back, unlike
+        ``set_mgmt_ip``, which drops the session that issues it.
+
+        The Plus models cannot be renamed by this library yet -- they have
+        neither backend, and the NSDP and web-UI routes are unbuilt.
+        """
+        self._write(lambda w: w.set_hostname(name, force=force), backend)
+
     def set_mgmt_ip(
         self,
         address: str,

{python_netgear_switch_library-0.0.post341 → python_netgear_switch_library-0.0.post342}/tests/test_capabilities.py

@@ -93,6 +93,10 @@ _WRITE_ARGS: dict[str, tuple[tuple[Any, ...], dict[str, Any]]] = {
     "create_vlan": ((4008, "capcheck"), {}),
     "delete_vlan": ((4008,), {}),
     "set_mgmt_ip": (("10.99.0.2", "255.255.255.0", "10.99.0.1"), {}),
+    # A non-empty name: set_hostname refuses an empty one outright, because
+    # `hostname` with no argument is rejected by the device itself and clearing
+    # a name is a different command (`no hostname`) that is not implemented.
+    "set_hostname": (("capcheck",), {}),
 }
 
 #: Not driven. ``upload_certificate_scp`` runs a multi-command deploy sequence