fix(driver): load_replace_candidate is None, not a stub that raises (NetOrk/netork#2503) #81

Merged
christianmanivong merged 2 commits from fix/no-config-replace into main 2026-11-13 21:39:04 +00:00
4 changed files with 24 additions and 3 deletions

No files matched your search

+4
View File
@@ -21,6 +21,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
`NotImplementedError`.
### Changed
- `load_replace_candidate` is `None` instead of a method that raises
`NotImplementedError`, so a caller that asks whether the driver can replace a
configuration gets no. netOrk offered a config restore for these devices that
could only fail (NetOrk/netork#2503).
- On an rpm host a package's version carries its epoch where it has one
(`1:6.2.0-13.el9`), as on a dpkg host. Oracle's and Red Hat's fixes name it, and without
it an epoch-1 fix read as newer than every installed build (NetOrk/netork#2394).
+1 -1
View File
@@ -91,7 +91,7 @@ with Driver(
| `get_config()` | ✅ | Returns `ip addr` + `ip route` output |
| `ping()` | ✅ | Executes `ping` on the remote host |
| `load_merge_candidate()` | ❌ | Not applicable for generic Linux |
| `load_replace_candidate()` | ❌ | Not applicable for generic Linux |
| `load_replace_candidate()` | ❌ | Not applicable for generic Linux; `None`, so a caller can tell |
| `compare_config()` | ❌ | Not applicable for generic Linux |
| `commit_config()` | ❌ | Not applicable for generic Linux |
| `discard_config()` | ❌ | Not applicable for generic Linux |
+2 -2
View File
@@ -1009,8 +1009,8 @@ class LinuxDriver(
def load_merge_candidate(self, filename: str = None, config: str = None) -> None: # type: ignore[override]
raise NotImplementedError("Config management is not supported for Linux hosts")
def load_replace_candidate(self, filename: str = None, config: str = None) -> None: # type: ignore[override]
raise NotImplementedError("Config management is not supported for Linux hosts")
#: No config replace, switched off so a capability check says no (NetOrk/netork#2503).
load_replace_candidate = None # type: ignore[assignment]
def compare_config(self) -> str:
raise NotImplementedError("Config management is not supported for Linux hosts")
+17
View File
@@ -0,0 +1,17 @@
"""The driver cannot replace a device's configuration, and says so by not having the method.
A ``load_replace_candidate`` that only raises looks like a replace to anyone who asks
whether the driver has one: netOrk offered a config restore for these devices that
could only fail (NetOrk/netork#2503). ``None`` is how a driver switches off a method
it would otherwise inherit, the convention of napalm-device-types and netOrk's
capability checks.
"""
from __future__ import annotations
from napalm_linux import LinuxDriver
def test_the_driver_has_no_config_replace():
assert LinuxDriver.load_replace_candidate is None
assert not callable(getattr(LinuxDriver, "load_replace_candidate", None))