Files
napalm-zyxel/CHANGELOG.md
T
Christian Manivong ded19238c0
driver / standard (pull_request) Successful in 17s
driver / lint (pull_request) Successful in 15s
driver / types (pull_request) Successful in 1m10s
driver / test (3.12) (pull_request) Successful in 4m10s
driver / test (3.13) (pull_request) Successful in 4m6s
driver / lowest (pull_request) Successful in 3m43s
driver / build (pull_request) Successful in 31s
driver / security (pull_request) Successful in 1m17s
CI / driver (pull_request) Successful in 5m59s
driver / publish (pull_request) Skipped
fix(dal): raise on a failed request instead of reading it as empty
_dal_query and _fetch_page returned None for any failure, and the
getters turned that into empty data, so a timeout or an expired session
read as a gateway with no hosts, port forwards, SSIDs or Wi-Fi clients.
Both now raise: ConnectionException when the gateway does not answer or
refuses the session, RuntimeError naming the request otherwise. A getter
whose DAL request fails still reads the HTML page and raises when that
fails too; get_facts no longer swallows a failed get_interfaces.

Closes #15
2026-11-02 09:18:50 +01:00

3.3 KiB
Raw Blame History

Changelog

All notable changes to this driver. The format follows Keep a Changelog, versions follow Semantic Versioning.

[Unreleased]

Changed

  • Python 3.12 is the floor (requires-python = ">=3.12"): netOrk runs every driver on 3.12, so 3.10 and 3.11 are no longer tested (NAPALM/driver-standard#6).
  • The floor on napalm is 5.1: older releases import pkg_resources, which a Python 3.12 venv no longer has.

Fixed

  • A failed request to the gateway raises instead of reading as empty data (#15). A timeout, a refused session or an HTTP error made get_hosts, get_arp_table, get_port_forwards, get_nat_translations, get_wireless_clients, get_ssids, get_radio_status and get_diagnostics report a gateway with nothing configured. They raise ConnectionException when the gateway does not answer or refuses the session (HTTP 401/403) and RuntimeError naming the request otherwise. A getter whose DAL request fails still reads the HTML page, and raises when that fails too. get_facts no longer reports an empty interface list when the interfaces cannot be read, and reboot_host / restart_wifi raise the same way when the request fails.
  • get_arp_table() reports an unknown age as -1.0 (napalm-device-types' ARP_AGE_UNKNOWN) instead of 0.0, which means "confirmed just now": the host list says a host is active, not when the gateway last saw it (NetOrk/netork#1327).
  • The HTTP fingerprint no longer counts gs1920 and gs2210 as evidence for this driver: they are Zyxel switches, and discovery offered this gateway driver for them (#4).
  • Discovery tells a DAL gateway from any other Zyxel device (#13). The Zyxel enterprise OID, a Zyxel OUI and "zyxel" on the web page fit every Zyxel switch, firewall or NAS, and together they were this driver's whole maximum score. Discovery now also fetches /getRSAPublickKey on ports 80 and 443 (the key exchange the driver logs in with, answered without a login), and its "RSAPublicKey" answer weighs 24. Vendor-wide evidence alone comes to 28 of 52, below "high"; a gateway with SNMP scores 52 of 52, one without SNMP 37 of 52.
  • Every HTTP request to the gateway carries the driver's timeout. It was set on the session, where requests ignores it, so an unresponsive gateway could hang a call indefinitely (#3).
  • ping() no longer reports every target as alive. The DAL only acknowledges a PINGTEST request and never says whether the target answered, so ping() now returns an error and the driver opts out of ping sweeps (SUPPORTS_PING = False): a LAN scan through this gateway marked every address alive (#2).

[0.3.0] - 2026-10-23

The first release on PyPI.

Changed

  • The driver follows the NAPALM driver standard (https://git.netork.io/NAPALM/driver-standard): CI on Gitea runs ruff, mypy, the tests on Python 3.10–3.13 and at the lowest declared versions, bandit, pip-audit and a build check, and a release tag publishes to PyPI. The package now ships py.typed, a README and a LICENSE file. Python 3.9 is no longer supported; napalm-device-types never ran on it. It needs napalm-device-types 4.21.1 or later.
  • A failed login keeps the underlying error as the cause of the ConnectionException.