Files
napalm-openwrt/CHANGELOG.md
T
Christian Manivong 071beeb68a
driver / standard (pull_request) Successful in 18s
driver / lint (pull_request) Successful in 28s
driver / types (pull_request) Failing after 30s
driver / test (3.13) (pull_request) Failing after 15s
driver / test (3.12) (pull_request) Failing after 17s
driver / lowest (pull_request) Failing after 18s
driver / build (pull_request) Successful in 35s
driver / security (pull_request) Failing after 40s
CI / driver (pull_request) Failing after 1m41s
driver / publish (pull_request) Skipped
fix(lldp): report the neighbour's chassis MAC
lldpd tells the chassis MAC, but get_lldp_neighbors reported only name
and port, so netOrk, which matches a neighbour by MAC first, could match
OpenWrt's neighbours by name only. napalm-device-types' lldp_neighbors
projection now carries mac (lower case) when the chassis id is a MAC
address, as napalm-linux reports it.

Closes #31
2026-11-02 08:51:27 +01:00

4.6 KiB
Raw Blame History

Changelog

All notable changes to napalm-openwrt. The format follows Keep a Changelog, versions follow Semantic Versioning. Versions up to 0.6.0 were not recorded here; their history is the git log.

[Unreleased]

Added

  • configure_lldp_agent(interfaces) (napalm-device-types LldpAgentMixin): installs lldpd where it is missing, writes the interfaces given as lldpd's interface list in UCI, enables lldpd at boot and restarts it. A VLAN device (br-ap.10) is written as the device under it (br-ap). It is the action for the setup the LLDP getters used to do on every poll (#8). Needs napalm-device-types with LldpAgentMixin.

Changed

  • The floor on napalm-device-types is 4.24.0, the first release with what this driver uses (its shared lldpctl parser).
  • 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.
  • get_lldp_neighbors() and get_lldp_neighbors_detail() only read. They no longer enable and start a stopped lldpd, and no longer rewrite lldpd's interface list and restart it, which could happen on every poll. A device whose lldpd is stopped now reports no neighbours until lldpd is started, for example with manage_service("lldpd", "enable") and manage_service("lldpd", "start") (#8).

Fixed

  • get_lldp_neighbors() and get_lldp_neighbors_detail() keep an interface name with a dot whole: the neighbours of a VLAN interface such as eth0.1 used to come back under eth0 with every field empty (#26). A neighbour that names its port by MAC address or a local id is reported with that port instead of an empty one, and a chassis named by a local id or an address with that id. The detail now also carries the neighbour's system description and capabilities, which were always empty. lldpd's output is parsed by napalm-device-types' shared parser.
  • get_lldp_neighbors() reports a neighbour's chassis MAC as mac (lower case) when the neighbour names its chassis by one, as napalm-linux does, so netOrk can match the neighbour by MAC rather than by name only (#31).
  • get_lldp_neighbors() and get_lldp_neighbors_detail() raise when lldpctl fails (not installed, lldpd not running or unreachable), with lldpctl's message; they used to return no neighbours, the same answer as a device without any (#27). An empty result now means lldpctl ran and listed none. get_environment() raises when /proc/stat or /proc/meminfo cannot be read or parsed, instead of reporting 0 % CPU and 0 bytes of memory.
  • 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": neither ip neigh nor /proc/net/arp has an age (NetOrk/netork#1327).
  • The driver no longer removes port from the optional_args dict it is given: the caller's dict stays as it was (#19).
  • manage_service() reports a failed action or a missing init script as failed: only the init script's exit status decides, where any action used to come back as a success (#3).
  • apply_updates() reports a failed upgrade as failed, with the package manager's exit status in error; it used to report every upgrade as done (#11).
  • get_environment() reports the CPU usage of the last second, from two reads of /proc/stat one second apart; it used to report the average since boot, so a box busy for the last minute could show a low figure (#10).
  • get_lldp_neighbors() and get_lldp_neighbors_detail() report every neighbour on a port (a phone with a PC behind it, a switch without LLDP of its own); only the last one came back, mixed with fields of the others (#9).

[0.7.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 and a LICENSE file. Python 3.8 and 3.9 are no longer supported; napalm-device-types never ran on them.
  • napalm-device-types 4.21.1 or newer is required.
  • Exceptions the driver deliberately ignores (the snmpd community in get_snmp_config(), the network VLANs in get_ssids()) are now logged at debug level.
  • The project links point at git.netork.io instead of GitHub.