Merge branch 'main' into T8989_update_get_vauleT8989_update_get_vaule

2 files changed, 353 insertions, 355 deletions

diff --git a/tests/unit/modules/test_vyos_l3_interfaces.py b/tests/unit/modules/test_vyos_l3_interfaces.py
index 66cd1fc..79fc8cf 100644
--- a/tests/unit/modules/test_vyos_l3_interfaces.py
+++ b/tests/unit/modules/test_vyos_l3_interfaces.py
@@ -4,300 +4,216 @@ from __future__ import absolute_import, division, print_function
 
 __metaclass__ = type
 
-import json
-import os
 import unittest
 
 from unittest.mock import MagicMock
 
 from ansible_collections.vyos.rest.plugins.modules.vyos_l3_interfaces import (
     _addr_cmds,
-    _addr_list,
-    _normalize,
-    _parse_iface,
+    _device_to_argspec,
+    _guess_iface_type,
+    _iface_base,
+    _resolve_iface_type,
     _split_addresses,
+    _vif_addr_cmds,
     build_commands,
     get_running_config,
 )
 
+from .base import load_fixture
 
-def load_fixture(filename):
-    fixtures_dir = os.path.join(os.path.dirname(__file__), "..", "fixtures")
-    path = os.path.join(fixtures_dir, filename)
-    with open(path) as f:
-        return json.load(f)
+
+_BASE = ["interfaces"]
 
 
 class VyOSModuleTestCase(unittest.TestCase):
     def setUp(self):
         self.mock_vyos = MagicMock()
-        self.mock_vyos.get_config = MagicMock(return_value={})
-
-    def set_running_config(self, data):
-        self.mock_vyos.get_config.return_value = data
-
-
-class TestVyOSL3InterfacesAddrList(unittest.TestCase):
-
-    def test_string_returns_list(self):
-        self.assertEqual(_addr_list("dhcp"), ["dhcp"])
-
-    def test_list_returned_sorted(self):
-        result = _addr_list(["10.0.0.2/32", "10.0.0.1/32"])
-        self.assertEqual(result, ["10.0.0.1/32", "10.0.0.2/32"])
-
-    def test_none_returns_empty(self):
-        self.assertEqual(_addr_list(None), [])
-
-    def test_empty_list_returns_empty(self):
-        self.assertEqual(_addr_list([]), [])
-
-
-class TestVyOSL3InterfacesSplitAddresses(unittest.TestCase):
-
-    def test_dhcp_goes_to_ipv4(self):
-        ipv4, ipv6 = _split_addresses(["dhcp"])
-        self.assertIn("dhcp", ipv4)
-        self.assertEqual(ipv6, [])
-
-    def test_dhcpv6_goes_to_ipv6(self):
-        ipv4, ipv6 = _split_addresses(["dhcpv6"])
-        self.assertEqual(ipv4, [])
-        self.assertIn("dhcpv6", ipv6)
-
-    def test_ipv4_cidr(self):
-        ipv4, ipv6 = _split_addresses(["192.0.2.1/24"])
-        self.assertIn("192.0.2.1/24", ipv4)
-        self.assertEqual(ipv6, [])
-
-    def test_ipv6_cidr(self):
-        ipv4, ipv6 = _split_addresses(["2001:db8::1/128"])
-        self.assertEqual(ipv4, [])
-        self.assertIn("2001:db8::1/128", ipv6)
-
-    def test_mixed(self):
-        ipv4, ipv6 = _split_addresses(["dhcp", "192.0.2.1/24", "2001:db8::1/128"])
-        self.assertIn("dhcp", ipv4)
-        self.assertIn("192.0.2.1/24", ipv4)
-        self.assertIn("2001:db8::1/128", ipv6)
-
-
-class TestVyOSL3InterfacesParseIface(unittest.TestCase):
-
-    def test_parse_dhcp(self):
-        result = _parse_iface("eth0", {"address": "dhcp"})
-        self.assertEqual(result["name"], "eth0")
-        self.assertEqual(result["ipv4"], [{"address": "dhcp"}])
-
-    def test_parse_multiple_addresses(self):
-        result = _parse_iface("lo", {"address": ["10.0.0.1/32", "10.0.0.2/32"]})
-        addrs = [a["address"] for a in result["ipv4"]]
-        self.assertIn("10.0.0.1/32", addrs)
-        self.assertIn("10.0.0.2/32", addrs)
-
-    def test_parse_vif(self):
-        result = _parse_iface(
-            "eth0",
-            {
-                "address": "dhcp",
-                "vif": {"100": {"address": "192.0.2.100/24"}},
-            },
-        )
-        self.assertIn("vifs", result)
-        self.assertEqual(result["vifs"][0]["vlan_id"], 100)
-        self.assertEqual(result["vifs"][0]["ipv4"][0]["address"], "192.0.2.100/24")
-
-    def test_parse_no_address(self):
-        result = _parse_iface("lo", {})
-        self.assertNotIn("ipv4", result)
-        self.assertNotIn("ipv6", result)
-
-    def test_hw_id_ignored(self):
-        result = _parse_iface("eth0", {"hw-id": "52:54:00:65:5a:24"})
-        self.assertNotIn("hw_id", result)
-        self.assertNotIn("hw-id", result)
-
-
-class TestVyOSL3InterfacesGetRunningFixture(VyOSModuleTestCase):
-
-    def setUp(self):
-        super().setUp()
         self.fixture = load_fixture("l3_interfaces_running.json")
+        self.mock_vyos.get_config = MagicMock(return_value=self.fixture)
 
-    def test_fixture_parses_eth0_dhcp(self):
-        self.set_running_config(self.fixture)
-        result = get_running_config(self.mock_vyos)
-        eth0 = next((e for e in result if e["name"] == "eth0"), None)
-        self.assertIsNotNone(eth0)
-        addrs = [a["address"] for a in eth0.get("ipv4", [])]
-        self.assertIn("dhcp", addrs)
+    def gather(self):
+        return _device_to_argspec(self.fixture)
 
-    def test_fixture_parses_loopback_addresses(self):
-        self.set_running_config(self.fixture)
-        result = get_running_config(self.mock_vyos)
-        lo = next((e for e in result if e["name"] == "lo"), None)
-        self.assertIsNotNone(lo)
-        addrs = [a["address"] for a in lo.get("ipv4", [])]
-        self.assertIn("10.0.0.1/32", addrs)
-        self.assertIn("10.0.0.2/32", addrs)
-
-    def test_fixture_parses_vif(self):
-        self.set_running_config(self.fixture)
-        result = get_running_config(self.mock_vyos)
-        eth0 = next(e for e in result if e["name"] == "eth0")
-        self.assertIn("vifs", eth0)
-        self.assertEqual(eth0["vifs"][0]["vlan_id"], 100)
-
-    def test_empty_interface_not_included(self):
-        self.set_running_config(self.fixture)
-        result = get_running_config(self.mock_vyos)
-        names = [e["name"] for e in result]
-        # loopback with no addresses should not appear
-        self.assertNotIn("dummy0", names)
-
-
-class TestVyOSL3InterfacesGetRunning(VyOSModuleTestCase):
 
-    def test_empty_returns_empty_list(self):
-        self.set_running_config({})
+class TestGetRunningConfig(VyOSModuleTestCase):
+    def test_returns_config_directly(self):
         result = get_running_config(self.mock_vyos)
-        self.assertEqual(result, [])
-
-    def test_interface_without_address_excluded(self):
-        self.set_running_config(
-            {
-                "ethernet": {"eth0": {"hw-id": "52:54:00:65:5a:24"}},
-            },
-        )
-        result = get_running_config(self.mock_vyos)
-        self.assertEqual(result, [])
-
-
-class TestVyOSL3InterfacesNormalize(unittest.TestCase):
-
-    def test_normalize_ipv4(self):
-        config = [
-            {
-                "name": "lo",
-                "ipv4": [{"address": "10.0.0.1/32"}],
-            },
-        ]
-        result = _normalize(config)
-        self.assertIn("lo", result)
-        self.assertIn("10.0.0.1/32", result["lo"]["ipv4"])
-
-    def test_normalize_vif(self):
-        config = [
-            {
-                "name": "eth0",
-                "vifs": [{"vlan_id": 100, "ipv4": [{"address": "192.0.2.100/24"}]}],
-            },
-        ]
-        result = _normalize(config)
-        self.assertIn(100, result["eth0"]["vifs"])
-        self.assertIn("192.0.2.100/24", result["eth0"]["vifs"][100]["ipv4"])
-
-    def test_normalize_empty(self):
-        result = _normalize([])
-        self.assertEqual(result, {})
-
-
-class TestVyOSL3InterfacesAddrCmds(unittest.TestCase):
-
-    def test_adds_new_address(self):
-        base = ["interfaces", "loopback", "lo"]
-        cmds = _addr_cmds(base, ["10.0.0.1/32"], [], "merged")
-        self.assertIn(("set", base + ["address", "10.0.0.1/32"]), cmds)
-
-    def test_idempotent(self):
-        base = ["interfaces", "loopback", "lo"]
-        cmds = _addr_cmds(base, ["10.0.0.1/32"], ["10.0.0.1/32"], "merged")
-        self.assertEqual(cmds, [])
-
-    def test_merged_does_not_delete_extra(self):
-        base = ["interfaces", "loopback", "lo"]
-        cmds = _addr_cmds(base, ["10.0.0.1/32"], ["10.0.0.1/32", "10.0.0.2/32"], "merged")
-        self.assertEqual(cmds, [])
-
-    def test_replaced_deletes_extra(self):
-        base = ["interfaces", "loopback", "lo"]
-        cmds = _addr_cmds(base, ["10.0.0.1/32"], ["10.0.0.1/32", "10.0.0.2/32"], "replaced")
-        self.assertIn(("delete", base + ["address", "10.0.0.2/32"]), cmds)
-
-
-class TestVyOSL3InterfacesBuildCommands(unittest.TestCase):
-
-    def _have_lo(self):
-        return [
-            {
-                "name": "lo",
-                "ipv4": [
-                    {"address": "10.0.0.1/32"},
-                    {"address": "10.0.0.2/32"},
-                ],
-            },
-        ]
-
-    def test_merged_adds_address(self):
-        config = [{"name": "lo", "ipv4": [{"address": "10.0.0.3/32"}]}]
-        cmds = build_commands(config, [], "merged")
-        self.assertIn(
-            ("set", ["interfaces", "loopback", "lo", "address", "10.0.0.3/32"]),
-            cmds,
-        )
-
-    def test_merged_idempotent(self):
-        cmds = build_commands(self._have_lo(), self._have_lo(), "merged")
-        self.assertEqual(cmds, [])
-
-    def test_deleted_no_config_removes_all(self):
-        cmds = build_commands([], self._have_lo(), "deleted")
-        paths = [c[1] for c in cmds]
-        self.assertIn(["interfaces", "loopback", "lo", "address", "10.0.0.1/32"], paths)
-        self.assertIn(["interfaces", "loopback", "lo", "address", "10.0.0.2/32"], paths)
-
-    def test_deleted_with_config_removes_interface_addresses(self):
-        config = [{"name": "lo"}]
-        cmds = build_commands(config, self._have_lo(), "deleted")
-        paths = [c[1] for c in cmds]
-        self.assertIn(["interfaces", "loopback", "lo", "address", "10.0.0.1/32"], paths)
-
-    def test_deleted_idempotent_when_empty(self):
-        cmds = build_commands([], [], "deleted")
+        self.assertIn("ethernet", result)
+
+    def test_empty_config(self):
+        self.mock_vyos.get_config = MagicMock(return_value=None)
+        self.assertEqual(get_running_config(self.mock_vyos), {})
+
+    def test_collapsed_response_normalized(self):
+        self.mock_vyos.get_config = MagicMock(return_value="eth0")
+        self.assertEqual(get_running_config(self.mock_vyos), {"eth0": {}})
+
+
+class TestTypeResolution(unittest.TestCase):
+    def test_resolves_from_have_when_present(self):
+        raw_have = {"loopback": {"lo": {}}}
+        self.assertEqual(_resolve_iface_type("lo", raw_have), "loopback")
+
+    def test_falls_back_to_guess_for_new_interface(self):
+        self.assertEqual(_resolve_iface_type("eth5", {}), "ethernet")
+
+    def test_guess_covers_all_11_types_aligned_with_vyos_interfaces(self):
+        """Confirmed original inconsistency: this module's own type
+        table was missing ppp/wlan compared to vyos_interfaces' table,
+        despite both modules operating on the same interface
+        namespace. Aligned here."""
+        expected = {
+            "eth0": "ethernet",
+            "bond0": "bonding",
+            "lo": "loopback",
+            "tun0": "tunnel",
+            "wg0": "wireguard",
+            "vti0": "vti",
+            "dum0": "dummy",
+            "vtun0": "openvpn",
+            "ppp0": "pppoe",
+            "wlan0": "wireless",
+            "br0": "bridge",
+        }
+        for name, itype in expected.items():
+            self.assertEqual(_guess_iface_type(name), itype)
+
+    def test_iface_base_uses_resolved_type(self):
+        raw_have = {"bonding": {"bond0": {}}}
+        self.assertEqual(_iface_base("bond0", raw_have), ["interfaces", "bonding", "bond0"])
+
+
+class TestSplitAddresses(unittest.TestCase):
+    def test_ipv4_ipv6_dhcp_dhcpv6(self):
+        ipv4, ipv6 = _split_addresses(["192.0.2.1/24", "2001:db8::1/64", "dhcp", "dhcpv6"])
+        self.assertEqual(ipv4, ["192.0.2.1/24", "dhcp"])
+        self.assertEqual(ipv6, ["2001:db8::1/64", "dhcpv6"])
+
+    def test_auto_config(self):
+        ipv4, ipv6 = _split_addresses(["auto-config"])
+        self.assertEqual(ipv6, ["auto-config"])
+
+
+class TestAddrCmds(unittest.TestCase):
+    """Confirmed scoped correctly: address commands only ever touch
+    the "address" leaf under the given base, regardless of whether
+    that base is an interface or a vif."""
+
+    def test_set_new_address(self):
+        cmds = _addr_cmds(["interfaces", "ethernet", "eth0"], ["192.0.2.1/24"], [], "merged")
+        expected = ("set", ["interfaces", "ethernet", "eth0", "address", "192.0.2.1/24"])
+        self.assertEqual(cmds, [expected])
+
+    def test_merged_never_deletes(self):
+        cmds = _addr_cmds(["interfaces", "ethernet", "eth0"], [], ["192.0.2.1/24"], "merged")
         self.assertEqual(cmds, [])
 
-    def test_replaced_removes_extra_address(self):
-        config = [{"name": "lo", "ipv4": [{"address": "10.0.0.1/32"}]}]
-        cmds = build_commands(config, self._have_lo(), "replaced")
-        self.assertIn(
-            ("delete", ["interfaces", "loopback", "lo", "address", "10.0.0.2/32"]),
-            cmds,
+    def test_replaced_deletes_omitted(self):
+        cmds = _addr_cmds(["interfaces", "ethernet", "eth0"], [], ["192.0.2.1/24"], "replaced")
+        expected = ("delete", ["interfaces", "ethernet", "eth0", "address", "192.0.2.1/24"])
+        self.assertEqual(cmds, [expected])
+
+
+class TestVifAddrCmdsNeverWholeSubtree(unittest.TestCase):
+    """Primary confirmed severe bug: the original generated a whole-
+    VIF delete (`delete ... vif <id>`) for an omitted VIF under
+    replaced/overridden/deleted. Since VIFs are shared with
+    vyos_interfaces (which owns description/mtu/disable on them),
+    this would destroy that module's own fields, not just this
+    module's addresses. Confirmed 4 separate occurrences in the
+    original build_commands. Fixed: every VIF operation here is
+    scoped to exactly the address leaf, never the VIF subtree."""
+
+    def test_omitted_vif_only_deletes_its_addresses(self):
+        have_vifs = {100: {"ipv4": ["192.0.2.100/24"], "ipv6": []}}
+        cmds = _vif_addr_cmds(["interfaces", "ethernet", "eth0"], {}, have_vifs, "replaced")
+        whole_vif_delete = ("delete", ["interfaces", "ethernet", "eth0", "vif", "100"])
+        self.assertNotIn(whole_vif_delete, cmds)
+        vif_addr_delete = (
+            "delete",
+            ["interfaces", "ethernet", "eth0", "vif", "100", "address", "192.0.2.100/24"],
         )
-
-    def test_overridden_removes_unlisted_interface(self):
-        config = [{"name": "lo", "ipv4": [{"address": "10.0.0.1/32"}]}]
-        have = self._have_lo() + [
-            {
-                "name": "eth0",
-                "ipv4": [{"address": "192.0.2.1/24"}],
-            },
-        ]
-        cmds = build_commands(config, have, "overridden")
-        self.assertIn(
-            ("delete", ["interfaces", "ethernet", "eth0", "address", "192.0.2.1/24"]),
-            cmds,
-        )
-
-    def test_vif_added(self):
+        self.assertIn(vif_addr_delete, cmds)
+
+    def test_deleted_state_also_never_whole_subtree(self):
+        have_vifs = {100: {"ipv4": ["192.0.2.100/24"], "ipv6": []}}
+        cmds = _vif_addr_cmds(["interfaces", "ethernet", "eth0"], {}, have_vifs, "deleted")
+        whole_vif_delete = ("delete", ["interfaces", "ethernet", "eth0", "vif", "100"])
+        self.assertNotIn(whole_vif_delete, cmds)
+
+    def test_overridden_also_never_whole_subtree(self):
+        have_vifs = {100: {"ipv4": ["192.0.2.100/24"], "ipv6": []}}
+        cmds = _vif_addr_cmds(["interfaces", "ethernet", "eth0"], {}, have_vifs, "overridden")
+        whole_vif_delete = ("delete", ["interfaces", "ethernet", "eth0", "vif", "100"])
+        self.assertNotIn(whole_vif_delete, cmds)
+
+
+class TestDeviceToArgspecFixture(VyOSModuleTestCase):
+    def test_all_interfaces_with_addresses_present(self):
+        have = self.gather()
+        names = {e["name"] for e in have}
+        # eth1 has no addresses at all -- must not appear
+        self.assertEqual(names, {"eth0", "lo"})
+
+    def test_eth0_addresses_and_vif_parsed(self):
+        have = self.gather()
+        eth0 = next(e for e in have if e["name"] == "eth0")
+        self.assertEqual(eth0["ipv4"][0]["address"], "192.0.2.1/24")
+        self.assertEqual(eth0["ipv6"][0]["address"], "2001:db8::1/64")
+        self.assertEqual(eth0["vifs"][0]["vlan_id"], 100)
+        self.assertEqual(eth0["vifs"][0]["ipv4"][0]["address"], "192.0.2.100/24")
+
+    def test_collapsed_single_address_string(self):
+        entry = _device_to_argspec({"ethernet": {"eth0": {"address": "192.0.2.1/24"}}})
+        self.assertEqual(entry[0]["ipv4"][0]["address"], "192.0.2.1/24")
+
+
+class TestBuildCommands(VyOSModuleTestCase):
+    def test_merged_idempotent_against_own_fixture(self):
+        have = self.gather()
+        self.assertEqual(build_commands(have, self.fixture, "merged"), [])
+
+    def test_replaced_idempotent_against_own_fixture(self):
+        have = self.gather()
+        self.assertEqual(build_commands(have, self.fixture, "replaced"), [])
+
+    def test_deleted_all_never_whole_interface_subtree(self):
+        raw_have = {"ethernet": {"eth0": {"address": ["192.0.2.1/24"]}}}
+        cmds = build_commands([], raw_have, "deleted")
+        self.assertNotIn(("delete", _BASE + ["ethernet", "eth0"]), cmds)
+        self.assertIn(("delete", _BASE + ["ethernet", "eth0", "address", "192.0.2.1/24"]), cmds)
+
+    def test_deleted_named_never_whole_interface_subtree(self):
+        raw_have = {"ethernet": {"eth0": {"address": ["192.0.2.1/24"]}}}
+        cmds = build_commands([{"name": "eth0"}], raw_have, "deleted")
+        self.assertNotIn(("delete", _BASE + ["ethernet", "eth0"]), cmds)
+
+    def test_overridden_omitted_interface_never_whole_subtree(self):
+        raw_have = {"ethernet": {"eth0": {"address": ["192.0.2.1/24"]}}}
+        cmds = build_commands([], raw_have, "overridden")
+        self.assertNotIn(("delete", _BASE + ["ethernet", "eth0"]), cmds)
+
+    def test_merged_adds_without_removing(self):
+        raw_have = {"ethernet": {"eth0": {"address": ["192.0.2.1/24"]}}}
+        config = [{"name": "eth0", "ipv4": [{"address": "192.0.2.2/24"}]}]
+        cmds = build_commands(config, raw_have, "merged")
+        self.assertIn(("set", _BASE + ["ethernet", "eth0", "address", "192.0.2.2/24"]), cmds)
+        self.assertFalse(any(c[0] == "delete" for c in cmds))
+
+    def test_replaced_removes_unlisted_address(self):
+        raw_have = {"ethernet": {"eth0": {"address": ["192.0.2.1/24", "192.0.2.2/24"]}}}
+        config = [{"name": "eth0", "ipv4": [{"address": "192.0.2.1/24"}]}]
+        cmds = build_commands(config, raw_have, "replaced")
+        self.assertIn(("delete", _BASE + ["ethernet", "eth0", "address", "192.0.2.2/24"]), cmds)
+
+    def test_merged_new_vif_address(self):
         config = [
-            {
-                "name": "eth0",
-                "vifs": [{"vlan_id": 100, "ipv4": [{"address": "192.0.2.100/24"}]}],
-            },
+            {"name": "eth0", "vifs": [{"vlan_id": 200, "ipv4": [{"address": "192.0.2.200/24"}]}]},
         ]
-        cmds = build_commands(config, [], "merged")
+        cmds = build_commands(config, {}, "merged")
         self.assertIn(
-            ("set", ["interfaces", "ethernet", "eth0", "vif", "100", "address", "192.0.2.100/24"]),
+            ("set", _BASE + ["ethernet", "eth0", "vif", "200", "address", "192.0.2.200/24"]),
             cmds,
         )
 
diff --git a/tests/unit/modules/test_vyos_ospfv3.py b/tests/unit/modules/test_vyos_ospfv3.py
index a84041b..a19b5fa 100644
--- a/tests/unit/modules/test_vyos_ospfv3.py
+++ b/tests/unit/modules/test_vyos_ospfv3.py
@@ -4,136 +4,218 @@ from __future__ import absolute_import, division, print_function
 
 __metaclass__ = type
 
-import json
-import os
 import unittest
 
 from unittest.mock import MagicMock
 
 from ansible_collections.vyos.rest.plugins.modules.vyos_ospfv3 import (
+    _CONFIG_OPTIONS,
+    ARGUMENT_SPEC,
+    _area_entry_from_device,
+    _area_entry_to_device,
+    _derive_key_field,
+    _device_to_argspec,
+    _kebab_fields,
     build_commands,
+    cast_by_spec,
     get_running_config,
 )
 
+from .base import load_fixture
 
-def load_fixture(filename):
-    fixtures_dir = os.path.join(os.path.dirname(__file__), "..", "fixtures")
-    with open(os.path.join(fixtures_dir, filename)) as f:
-        return json.load(f)
+
+_BASE = ["protocols", "ospfv3"]
 
 
 class VyOSModuleTestCase(unittest.TestCase):
     def setUp(self):
         self.mock_vyos = MagicMock()
-        self.mock_vyos.get_config = MagicMock(return_value={})
-
-    def set_running_config(self, data):
-        self.mock_vyos.get_config.return_value = data
-
-
-class TestVyOSOspfv3Parse(VyOSModuleTestCase):
-
-    def setUp(self):
-        super().setUp()
         self.fixture = load_fixture("ospfv3_running.json")
+        self.mock_vyos.get_config = MagicMock(return_value=self.fixture)
 
-    def test_parses_parameters(self):
-        self.set_running_config(self.fixture)
-        result = get_running_config(self.mock_vyos)
-        self.assertEqual(result["parameters"]["router_id"], "192.0.2.10")
+    def gather(self):
+        have = _device_to_argspec(self.fixture)
+        cast_by_spec(have, _CONFIG_OPTIONS)
+        return have
 
-    def test_parses_redistribute(self):
-        self.set_running_config(self.fixture)
+
+class TestGetRunningConfig(VyOSModuleTestCase):
+    def test_returns_config_directly(self):
         result = get_running_config(self.mock_vyos)
-        route_types = [r["route_type"] for r in result["redistribute"]]
-        self.assertIn("bgp", route_types)
-        self.assertIn("connected", route_types)
-        connected = next(r for r in result["redistribute"] if r["route_type"] == "connected")
-        self.assertEqual(connected["route_map"], "RM1")
-
-    def test_parses_areas(self):
-        self.set_running_config(self.fixture)
+        self.assertIn("area", result)
+
+    def test_empty_config(self):
+        self.mock_vyos.get_config = MagicMock(return_value=None)
+        self.assertEqual(get_running_config(self.mock_vyos), {})
+
+    def test_collapsed_response_normalized(self):
+        """Regression coverage for the confirmed failure mode from
+        vyos_ospf_interfaces's build: an unguarded collapsed response
+        (VyOS's single-value tag-node quirk) would otherwise be
+        iterated character-by-character downstream."""
+        self.mock_vyos.get_config = MagicMock(return_value="eth1")
         result = get_running_config(self.mock_vyos)
-        self.assertEqual(len(result["areas"]), 2)
-        area2 = next(a for a in result["areas"] if a["area_id"] == "2")
-        self.assertEqual(area2["export_list"], "export1")
-        self.assertEqual(area2["import_list"], "import1")
-        self.assertEqual(len(area2["range"]), 2)
-        not_adv = next(r for r in area2["range"] if r["address"] == "2001:db20::/32")
-        self.assertTrue(not_adv["not_advertise"])
+        self.assertEqual(result, {"eth1": {}})
 
-    def test_empty_config_returns_empty(self):
-        self.set_running_config({})
-        result = get_running_config(self.mock_vyos)
-        self.assertEqual(result, {})
 
+class TestDeriveKeyField(unittest.TestCase):
+    def test_derives_area_id(self):
+        area_opts = ARGUMENT_SPEC["config"]["options"]["areas"]["options"]
+        self.assertEqual(_derive_key_field(area_opts), "area_id")
 
-class TestVyOSOspfv3BuildCommands(unittest.TestCase):
+    def test_raises_if_none_required(self):
+        with self.assertRaises(ValueError):
+            _derive_key_field({"a": {"type": "str"}})
 
-    def test_deleted_with_have(self):
-        have = {"parameters": {"router_id": "192.0.2.10"}}
-        cmds = build_commands({}, have, "deleted")
-        self.assertEqual(cmds, [("delete", ["protocols", "ospfv3"])])
 
-    def test_deleted_without_have(self):
-        cmds = build_commands({}, {}, "deleted")
-        self.assertEqual(cmds, [])
+class TestKebabFields(unittest.TestCase):
+    def test_converts_multiword_keys(self):
+        result = _kebab_fields({"router_id": "1.1.1.1"})
+        self.assertEqual(result, {"router-id": "1.1.1.1"})
 
-    def test_merged_parameters(self):
-        config = {"parameters": {"router_id": "192.0.2.10"}}
-        cmds = build_commands(config, {}, "merged")
-        self.assertIn(
-            ("set", ["protocols", "ospfv3", "parameters", "router-id", "192.0.2.10"]),
-            cmds,
+
+class TestAreaEntry(unittest.TestCase):
+    def test_export_import_list_to_device(self):
+        result = _area_entry_to_device({"export_list": "el1", "import_list": "il1"})
+        self.assertEqual(result, {"export-list": "el1", "import-list": "il1"})
+
+    def test_range_to_device(self):
+        result = _area_entry_to_device(
+            {"range": [{"address": "2001:db1::/32", "not_advertise": True}]},
         )
+        self.assertEqual(result, {"range": {"2001:db1::/32": {"not-advertise": {}}}})
 
-    def test_merged_redistribute(self):
-        config = {"redistribute": [{"route_type": "bgp"}]}
-        cmds = build_commands(config, {}, "merged")
-        self.assertIn(
-            ("set", ["protocols", "ospfv3", "redistribute", "bgp"]),
-            cmds,
+    def test_from_device(self):
+        entry = _area_entry_from_device(
+            {"export-list": "el1", "range": {"2001:db1::/32": {"advertise": {}}}},
         )
+        self.assertEqual(entry["export_list"], "el1")
+        self.assertEqual(entry["range"][0]["address"], "2001:db1::/32")
+        self.assertTrue(entry["range"][0]["advertise"])
+
+    def test_empty(self):
+        self.assertEqual(_area_entry_to_device({}), {})
+        self.assertEqual(_area_entry_from_device({}), {})
 
-    def test_merged_idempotent(self):
-        config = {"parameters": {"router_id": "192.0.2.10"}}
-        have = {"parameters": {"router_id": "192.0.2.10"}}
-        cmds = build_commands(config, have, "merged")
-        self.assertEqual(cmds, [])
 
-    def test_merged_area_range(self):
+class TestDeviceToArgspecFixture(VyOSModuleTestCase):
+    def test_areas_parsed(self):
+        have = self.gather()
+        area_ids = {a["area_id"] for a in have["areas"]}
+        self.assertEqual(area_ids, {"2", "3"})
+
+    def test_area_export_import_list_parsed(self):
+        have = self.gather()
+        area2 = next(a for a in have["areas"] if a["area_id"] == "2")
+        self.assertEqual(area2["export_list"], "export1")
+        self.assertEqual(area2["import_list"], "import1")
+
+    def test_range_advertise_not_advertise_parsed(self):
+        have = self.gather()
+        area2 = next(a for a in have["areas"] if a["area_id"] == "2")
+        r1 = next(r for r in area2["range"] if r["address"] == "2001:db10::/32")
+        r2 = next(r for r in area2["range"] if r["address"] == "2001:db20::/32")
+        self.assertNotIn("advertise", r1)
+        self.assertNotIn("not_advertise", r1)
+        self.assertTrue(r2["not_advertise"])
+
+        area3 = next(a for a in have["areas"] if a["area_id"] == "3")
+        self.assertTrue(area3["range"][0]["advertise"])
+
+    def test_parameters_parsed(self):
+        have = self.gather()
+        self.assertEqual(have["parameters"]["router_id"], "192.0.2.10")
+
+    def test_redistribute_parsed(self):
+        have = self.gather()
+        route_types = {r["route_type"] for r in have["redistribute"]}
+        self.assertEqual(route_types, {"bgp", "static"})
+        bgp = next(r for r in have["redistribute"] if r["route_type"] == "bgp")
+        self.assertEqual(bgp["route_map"], "redist-map")
+
+    def test_empty(self):
+        self.assertEqual(_device_to_argspec({}), {})
+        self.assertEqual(_device_to_argspec(None), {})
+
+
+class TestBuildCommands(VyOSModuleTestCase):
+    def test_merged_idempotent_against_own_fixture(self):
+        have = self.gather()
+        self.assertEqual(build_commands(have, self.fixture, "merged"), [])
+
+    def test_replaced_idempotent_against_own_fixture(self):
+        have = self.gather()
+        self.assertEqual(build_commands(have, self.fixture, "replaced"), [])
+
+    def test_changing_existing_range_flag_via_replaced(self):
+        """Primary confirmed bug from the original hand-rolled
+        implementation: range advertise/not_advertise were only ever
+        set on initial range creation (an "if addr not in have_ranges"
+        guard) -- changing an existing range's flag generated no
+        command under either state. dict_op's purge (via "replaced")
+        correctly handles this generically."""
+        raw_have = {"area": {"2": {"range": {"2001:db20::/32": {"not-advertise": {}}}}}}
         config = {
-            "areas": [{"area_id": "2", "range": [{"address": "2001:db10::/32"}]}],
+            "areas": [
+                {
+                    "area_id": "2",
+                    "range": [
+                        {"address": "2001:db20::/32", "advertise": True},
+                    ],
+                },
+            ],
         }
-        cmds = build_commands(config, {}, "merged")
+        cmds = build_commands(config, raw_have, "replaced")
         self.assertIn(
-            ("set", ["protocols", "ospfv3", "area", "2", "range", "2001:db10::/32"]),
+            ("delete", _BASE + ["area", "2", "range", "2001:db20::/32", "not-advertise"]),
             cmds,
         )
-
-    def test_replaced_idempotent(self):
-        config = {"parameters": {"router_id": "192.0.2.10"}}
-        have = {"parameters": {"router_id": "192.0.2.10"}}
-        cmds = build_commands(config, have, "replaced")
-        self.assertEqual(cmds, [])
-
-    def test_replaced_rebuilds_on_change(self):
-        config = {"parameters": {"router_id": "192.0.2.11"}}
-        have = {"parameters": {"router_id": "192.0.2.10"}}
-        cmds = build_commands(config, have, "replaced")
-        self.assertEqual(cmds[0], ("delete", ["protocols", "ospfv3"]))
         self.assertIn(
-            ("set", ["protocols", "ospfv3", "parameters", "router-id", "192.0.2.11"]),
+            ("set", _BASE + ["area", "2", "range", "2001:db20::/32", "advertise"]),
             cmds,
         )
 
-    def test_merged_area_export_list(self):
-        config = {"areas": [{"area_id": "2", "export_list": "export1"}]}
+    def test_merged_does_not_clear_conflicting_flag(self):
+        """merged never runs a purge pass, by design (established,
+        consistent semantic throughout this collection) -- confirms
+        it correctly does NOT clear not-advertise even when advertise
+        is set instead, unlike replaced above."""
+        raw_have = {"area": {"2": {"range": {"2001:db20::/32": {"not-advertise": {}}}}}}
+        config = {
+            "areas": [
+                {
+                    "area_id": "2",
+                    "range": [
+                        {"address": "2001:db20::/32", "advertise": True},
+                    ],
+                },
+            ],
+        }
+        cmds = build_commands(config, raw_have, "merged")
+        self.assertFalse(any(c[0] == "delete" and "not-advertise" in str(c) for c in cmds))
+
+    def test_replaced_is_whole_resource_not_scoped(self):
+        """Confirmed matching this module's own documented contract
+        ("replaced replaces the module-managed OSPFv3 configuration") and
+        vyos_ospfv2's own established precedent -- unlike
+        vyos_static_routes/vyos_route_maps, which scope replaced per
+        named item."""
+        raw_have = {"parameters": {"router-id": "1.1.1.1"}, "redistribute": {"bgp": {}}}
+        config = {"parameters": {"router_id": "1.1.1.1"}}
+        cmds = build_commands(config, raw_have, "replaced")
+        self.assertIn(("delete", _BASE + ["redistribute"]), cmds)
+
+    def test_deleted_with_have(self):
+        cmds = build_commands({}, {"parameters": {"router-id": "1.1.1.1"}}, "deleted")
+        self.assertEqual(cmds, [("delete", _BASE)])
+
+    def test_deleted_no_have_is_noop(self):
+        self.assertEqual(build_commands({}, {}, "deleted"), [])
+
+    def test_merged_new_area(self):
+        config = {"areas": [{"area_id": "5", "export_list": "el5"}]}
         cmds = build_commands(config, {}, "merged")
-        self.assertIn(
-            ("set", ["protocols", "ospfv3", "area", "2", "export-list", "export1"]),
-            cmds,
-        )
+        self.assertIn(("set", _BASE + ["area", "5", "export-list", "el5"]), cmds)
 
 
 if __name__ == "__main__":