Files
napalm-netgear/CHANGELOG.md
T
Christian Manivong 7e3c7d6285
driver / standard (pull_request) Successful in 18s
driver / lint (pull_request) Successful in 15s
driver / types (pull_request) Successful in 1m10s
driver / test (3.12) (pull_request) Successful in 1m17s
driver / test (3.13) (pull_request) Successful in 1m13s
driver / lowest (pull_request) Successful in 29s
driver / build (pull_request) Successful in 32s
driver / security (pull_request) Successful in 1m16s
CI / driver (pull_request) Successful in 3m7s
driver / publish (pull_request) Skipped
fix(plus): stop reporting unread or failed reads as empty
Netgear Plus answered reads its web interface cannot do (MAC table,
LLDP, config, users, SNMP, NTP) with empty values without asking the
switch; those now fall through to NAPALM's NotImplementedError, and the
switch-role getters that only returned {} (spanning tree, port channels,
802.1X, MAC ACL) are gone, as device-types reads capability from the
method being there. get_vlans_detail raises when vlan.cgi cannot be
read, get_vlans keys VLANs by int, and Smart get_snmp_config raises when
show snmp fails instead of reading as "no SNMP".

Closes #21
2026-11-02 09:22:22 +01:00

4.6 KiB
Raw Blame History

Changelog

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

[Unreleased]

Changed

  • Breaking: Netgear Plus get_vlans keys are int VLAN ids, as in NAPALM's get_vlans; they were strings ("1"). get_vlans_detail keeps its string keys (#21).
  • 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

  • Reads the Netgear Plus web interface cannot do raise NAPALM's own NotImplementedError instead of answering with empty values without asking the switch (#21): get_mac_address_table, get_lldp_neighbors, get_lldp_neighbors_detail, get_config, get_users, get_snmp_information, get_ntp_servers, get_ntp_peers and get_ntp_stats. An application can tell "not supported" from "read, none" again. get_arp_table still returns []: the switches are L2 only.
  • Netgear Plus get_vlans_detail and get_vlans raise when vlan.cgi cannot be read (ConnectionException when the request fails, RuntimeError for an error answer or an empty page). They reported a switch without VLANs (#21).
  • Smart get_snmp_config raises when show snmp fails. It returned None, the same as a switch without SNMP (#21).
  • The README's requirements match pyproject.toml: NAPALM 5.1 (it said 4.0), and paramiko and netaddr are listed (#22).
  • The README describes netgear_plus too (#19). Its getter table now has a column per driver: on Plus switches most getters return empty values without asking the switch, and cli, ping, get_route_to and the configuration methods raise NotImplementedError. Plus has its own tested model (GS308EP) and connection notes: password-only login over HTTP, optional_args and the Netmiko options do not apply.
  • get_arp_table() on Smart switches reports the age as -1.0 (unknown, napalm-device-types' ARP_AGE_UNKNOWN) instead of 0.0, which means "confirmed just now". The "Age (min)" column of show arp is not parsed until real switch output confirms its format (NetOrk/netork#1327).
  • A Netgear Plus switch is no longer offered as a ping-sweep source (supports_ping() is False): its ping only raised, so every target of a sweep came back as an error. ping still raises NotImplementedError, now NAPALM's own.
  • The Smart driver no longer adds its connection defaults (conn_timeout, banner_timeout, disabled_algorithms) to the optional_args dict the caller passed in.
  • An unexpected error while connecting to a Smart switch is reported in English ("Cannot connect to : ").
  • requirements.txt is gone: it repeated the dependencies of pyproject.toml with older floors (napalm 4.0, napalm-device-types 4.16) than the driver needs.

Removed

  • Breaking: the Netgear Plus driver no longer has get_spanning_tree, get_port_channels, get_dot1x_ports and get_mac_acl. They returned an empty dict without asking the switch; napalm-device-types declares them for switches that can read them, and an application tells that by the method being there (#21).
  • Breaking: the Netgear Plus driver no longer has set_vlan, delete_vlan and set_interface. They only raised NotImplementedError; an application that tells what a switch can do by whether the method exists offered VLAN and port editing on Plus switches, and the action then failed. A caller that caught NotImplementedError from them now finds no such attribute.

[0.6.0] - 2026-10-23

The first release on PyPI, under the new name napalm-netgear-switches.

Changed

  • The package is now called napalm-netgear-switches on PyPI (pip install napalm-netgear-switches): the name napalm-netgear belongs to another project. The import package napalm_netgear and the driver names netgear_smart and netgear_plus stay the same.
  • 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 and a LICENSE file. Python 3.8 and 3.9 are no longer supported; napalm-device-types never ran on them. It needs napalm-device-types 4.21.1 or later.
  • A failed logout when a Netgear Plus session is closed is now logged at debug level.