python-netgear-switch-library 0.0.post345__tar.gz → 0.0.post346__tar.gz

{python_netgear_switch_library-0.0.post345 → python_netgear_switch_library-0.0.post346}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-netgear-switch-library
-Version: 0.0.post345
+Version: 0.0.post346
 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.post345 → python_netgear_switch_library-0.0.post346}/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.post345'
-__version_tuple__ = version_tuple = (0, 0, 'post345')
+__version__ = version = '0.0.post346'
+__version_tuple__ = version_tuple = (0, 0, 'post346')
 
 __commit_id__ = commit_id = None

{python_netgear_switch_library-0.0.post345 → python_netgear_switch_library-0.0.post346}/src/netgear_switch/aio_api.py

@@ -95,6 +95,8 @@ if TYPE_CHECKING:
         PortStats,
         PortStatus,
         Sensor,
+        ServiceStatus,
+        SwitchUser,
         SyslogConfig,
         VLANInfo,
         VlanMode,
@@ -452,6 +454,20 @@ class AsyncSwitch:
         """Async twin of ``SyncSwitch.get_syslog`` -- see there."""
         return await self._read(lambda r: r.get_syslog(), backend)
 
+    async def get_users(self, *, backend: Backend | None = None) -> list[SwitchUser]:
+        """Async twin of ``SyncSwitch.get_users``.
+
+        AsyncSwitch has no CLI backend, so this refuses on every model -- the
+        same honest refusal every async CLI read gives.
+        """
+        return await self._read(lambda r: r.get_users(), backend)
+
+    async def get_services(
+        self, *, backend: Backend | None = None
+    ) -> list[ServiceStatus]:
+        """Async twin of ``SyncSwitch.get_services`` -- CLI only, see there."""
+        return await self._read(lambda r: r.get_services(), backend)
+
     async def get_hostname(self, *, backend: Backend | None = None) -> str:
         """Async twin of ``SyncSwitch.get_hostname`` -- see there."""
         return await self._read(lambda r: r.get_hostname(), backend)

{python_netgear_switch_library-0.0.post345 → python_netgear_switch_library-0.0.post346}/src/netgear_switch/capabilities.py

@@ -114,6 +114,28 @@ READ_OPERATIONS: tuple[Operation, ...] = (
     Operation("get_sensors", OperationKind.READ, "Fan/PSU/temperature sensors"),
     Operation("get_mgmt_ip", OperationKind.READ, "Management IP configuration"),
     Operation("get_hostname", OperationKind.READ, "The switch's host name"),
+    Operation(
+        "get_users",
+        OperationKind.READ,
+        "Local login accounts and their access level",
+        # CLI only, deliberately. The S3300's vendor SNMP user table holds ONE
+        # account where its own CLI lists two, so the two backends do not report
+        # the same set; claiming both serve this would assert an equivalence the
+        # hardware contradicts. Restricting it to the CLI makes no cross-backend
+        # claim at all, and leaves the SNMP question open rather than answered
+        # wrongly.
+        backends=_CLI_BACKENDS,
+    ),
+    Operation(
+        "get_services",
+        OperationKind.READ,
+        "Which management services (http/https/telnet/ssh) are enabled",
+        # CLI only so far: `show ip http`, `show telnetcon` and `show ip ssh`
+        # are measured, and the SNMP/HTTP/NSDP equivalents are unlocated rather
+        # than absent. The four models with no CLI backend therefore have no
+        # route to this yet, which the support table now shows as a hole.
+        backends=_CLI_BACKENDS,
+    ),
     Operation(
         "get_syslog",
         OperationKind.READ,

{python_netgear_switch_library-0.0.post345 → python_netgear_switch_library-0.0.post346}/src/netgear_switch/sync_api.py

@@ -157,6 +157,8 @@ if TYPE_CHECKING:
         PortStats,
         PortStatus,
         Sensor,
+        ServiceStatus,
+        SwitchUser,
         SyslogConfig,
         VLANInfo,
         VlanMode,
@@ -564,6 +566,23 @@ class SyncSwitch:
         """
         return self._read(lambda r: r.get_syslog(), backend)
 
+    def get_users(self, *, backend: Backend | None = None) -> list[SwitchUser]:
+        """The switch's local login accounts.
+
+        Served over the FASTPATH CLI. ``SwitchUser.access_mode`` keeps the
+        firmware's own wording, which differs between images, and
+        ``privileged`` carries the normalised reading.
+        """
+        return self._read(lambda r: r.get_users(), backend)
+
+    def get_services(self, *, backend: Backend | None = None) -> list[ServiceStatus]:
+        """Which management services are enabled, and on which ports.
+
+        Served over the FASTPATH CLI. A ``port`` of ``None`` means the firmware
+        reports no port for that service, not that a default applies.
+        """
+        return self._read(lambda r: r.get_services(), backend)
+
     def get_hostname(self, *, backend: Backend | None = None) -> str:
         """The switch's host name.