python-netgear-switch-library 0.0.post337__tar.gz → 0.0.post338__tar.gz

{python_netgear_switch_library-0.0.post337 → python_netgear_switch_library-0.0.post338}/PKG-INFO

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

{python_netgear_switch_library-0.0.post337 → python_netgear_switch_library-0.0.post338}/src/netgear_switch/http_read.py

@@ -380,6 +380,20 @@ def _with_fastpath_egress(
     return out
 
 
+def _has_sysinfo_hostname(spec: HttpModelSpec) -> bool:
+    """Whether this dialect's identity page carries the switch's host name.
+
+    True only for the two whose parsers extract it -- gs110emx's
+    ``sysInfo.html`` (``switch_name`` input) and gs105pe's ``switch_info.cgi``.
+    The FASTPATH/XE, M4300 and GoAhead identity pages were checked and carry no
+    host-name field, so their models read the name over SNMP or the CLI, both of
+    which they have.
+    """
+    return spec.sysinfo_path is not None and (
+        _is_gs110emx_dialect(spec) or _is_gs105pe_dialect(spec)
+    )
+
+
 def _parse_sysinfo(spec: HttpModelSpec, html: str) -> HttpSysInfo:
     """Dispatch the device-identity/mgmt-IP page: gs105pe's switch_info.cgi
     (lowercase ip_address inputs, dhcpMode select) vs gs110emx's sysInfo.html."""
@@ -629,6 +643,25 @@ class HttpReader:
             self._spec, self.session.get_page(self._spec.sysinfo_path)
         )
 
+    def get_hostname(self) -> str:
+        """The switch's host name, from its device-identity page.
+
+        Only the two dialects whose identity page actually carries the field can
+        serve this: gs110emx's ``sysInfo.html`` and gs105pe's
+        ``switch_info.cgi``, both of which already expose it as
+        ``HttpSysInfo.switch_name``. Every other dialect's identity page has no
+        such field, and is refused by name rather than returning "" -- an empty
+        string is a real host name on a switch that has never been named, so it
+        must not double as "this backend cannot tell you".
+        """
+        if not _has_sysinfo_hostname(self._spec):
+            raise _unsupported(self.model.key, "a host name field")
+        assert self._spec.sysinfo_path is not None  # guaranteed by the guard
+        info = _parse_sysinfo(
+            self._spec, self.session.get_page(self._spec.sysinfo_path)
+        )
+        return info.switch_name
+
     def get_mgmt_ip(self) -> MgmtIpConfig:
         path = _mgmt_ip_path(self._spec)
         if path is None: