testprotocols 0.8.0__tar.gz → 0.9.0__tar.gz

{testprotocols-0.8.0/src/testprotocols.egg-info → testprotocols-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testprotocols
-Version: 0.8.0
+Version: 0.9.0
 Summary: Common Test Resource Layer — capability and device protocols for telco testing.
 Author-email: Alottabits <rjvisser@alottabits.com>
 Maintainer-email: Alottabits <rjvisser@alottabits.com>

{testprotocols-0.8.0 → testprotocols-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "testprotocols"
-version = "0.8.0"
+version = "0.9.0"
 description = "Common Test Resource Layer — capability and device protocols for telco testing."
 requires-python = ">=3.12"
 dependencies = []

{testprotocols-0.8.0 → testprotocols-0.9.0}/src/testprotocols/__init__.py

@@ -1,6 +1,6 @@
 """testprotocols — capability and device Protocols for telco resources under test."""
 
-__version__ = "0.8.0"
+__version__ = "0.9.0"
 
 from testprotocols.aftr_gateway import AftrGateway
 from testprotocols.appliance_nat import ApplianceNat
@@ -99,6 +99,7 @@ from testprotocols.threat_prevention import ThreatPrevention
 from testprotocols.tr069_client import Tr069Client
 from testprotocols.tr069_server import Tr069Server
 from testprotocols.traffic_shaping import TrafficShaping
+from testprotocols.uplink_ports import UplinkPortRef, UplinkPorts
 from testprotocols.upnp_client import UpnpClient
 from testprotocols.vlan_client import VlanClient
 from testprotocols.wan_link_admin import WanLinkAdmin
@@ -206,6 +207,8 @@ __all__ = [
     "Tr069Server",
     "TrafficControllerDevice",
     "TrafficShaping",
+    "UplinkPortRef",
+    "UplinkPorts",
     "UpnpClient",
     "VlanClient",
     "WanLinkAdmin",

{testprotocols-0.8.0 → testprotocols-0.9.0}/src/testprotocols/devices/sdwan.py

@@ -26,6 +26,7 @@ from testprotocols.static_routes import StaticRoutes
 from testprotocols.syslog_config import SyslogConfig
 from testprotocols.threat_prevention import ThreatPrevention
 from testprotocols.traffic_shaping import TrafficShaping
+from testprotocols.uplink_ports import UplinkPorts
 from testprotocols.wan_link_admin import WanLinkAdmin
 
 
@@ -104,5 +105,11 @@ class SdwanApplianceDevice(BaseDeviceProtocol, Protocol):
     """Whether this session owns the appliance's network configuration —
     False for a warm-spare member whose primary owns the writes."""
 
+    uplink_ports: UplinkPorts
+    """Declared uplink→switch-port wiring — which managed-switch ports carry
+    each WAN uplink, one entry per pair member (see ``uplink_ports``). A
+    testbed that splices or re-VLANs an uplink resolves the ports here; the
+    switch's ``PlacementPorts`` stays the write authorization."""
+
 
 register_device_type("sdwan_appliance", SdwanApplianceDevice)

{testprotocols-0.8.0 → testprotocols-0.9.0}/src/testprotocols/models/sdwan_appliance.py

@@ -555,6 +555,23 @@ class UplinkSelectionRule:
     performance_class: str | None = None
 
 
+@dataclass(frozen=True)
+class UplinkSelectionSettings:
+    """The scalar half of the uplink-selection surface (read-only snapshot).
+
+    The network-wide settings that frame the ordered rule list: which uplink
+    carries default-routed traffic, whether load balancing across uplinks is
+    on, and whether the overlay runs tunnels over all active uplinks
+    concurrently (``active_active_vpn`` — a prerequisite on some products for
+    performance-class steering to evaluate at all). Frozen: a captured
+    snapshot is a restore target, so it must not mutate after capture.
+    """
+
+    default_uplink: str
+    load_balancing_enabled: bool
+    active_active_vpn: bool
+
+
 # --- Static routes ---
 
 

{testprotocols-0.8.0 → testprotocols-0.9.0}/src/testprotocols/sdwan_policy_manager.py

@@ -12,16 +12,23 @@ path steering (``set_uplink_selection`` /
 classes reuse ``SLAPolicy`` by name) landed 2026-06-12; the default
 (primary) uplink pair (``get_default_uplink`` / ``set_default_uplink``)
 landed 2026-07-03 — the network-wide "which uplink carries default-routed
-traffic" knob, distinct from per-flow steering. ``apply_policy`` remains
-the generic escape hatch for vendor-shaped policies beyond that surface.
-Application-match steering grows on evidence.
+traffic" knob, distinct from per-flow steering. The SLA read-back
+(``get_sla_policies``), the scalar-settings snapshot
+(``get_uplink_selection_settings``) and the concurrent-overlay-tunnels
+write (``set_active_active_vpn``) landed 2026-08-10 — the read-back and
+converge surface for the settings the rule list rides on. ``apply_policy``
+remains the generic escape hatch for vendor-shaped policies beyond that
+surface. Application-match steering grows on evidence.
 """
 
 from __future__ import annotations
 
 from typing import Any, Protocol, runtime_checkable
 
-from testprotocols.models.sdwan_appliance import UplinkSelectionRule
+from testprotocols.models.sdwan_appliance import (
+    UplinkSelectionRule,
+    UplinkSelectionSettings,
+)
 from testprotocols.models.wan_edge import AppFlow, SLAPolicy
 
 
@@ -86,3 +93,34 @@ class SdwanPolicyManager(Protocol):
     def get_uplink_selection(self) -> list[UplinkSelectionRule]:
         """Return the uplink-selection rules in evaluation order."""
         ...
+
+    def get_sla_policies(self) -> list[SLAPolicy]:
+        """Return the configured SLA policies (performance classes).
+
+        The read-back for ``configure_sla_policy`` / ``remove_sla_policy``:
+        thresholds as the product stores them, names as configured. Policies
+        the product created outside this session are included — a caller
+        arranging classes captures this read as its restore reference and
+        removes only what it configured.
+        """
+        ...
+
+    def get_uplink_selection_settings(self) -> UplinkSelectionSettings:
+        """Return the scalar settings framing the uplink-selection rule list.
+
+        One snapshot of the network-wide knobs — default uplink, load
+        balancing, concurrent overlay tunnels — read together so a caller
+        converging or restoring them works from a single consistent capture.
+        """
+        ...
+
+    def set_active_active_vpn(self, enabled: bool) -> None:
+        """Enable or disable concurrent overlay tunnels over all active uplinks.
+
+        On products where performance-class steering only evaluates with
+        concurrent tunnels enabled, this is the gate a testbed converges
+        before arranging classes. Read-back via
+        ``get_uplink_selection_settings``; the ordered rule list and the
+        default uplink are left untouched.
+        """
+        ...

{testprotocols-0.8.0 → testprotocols-0.9.0}/src/testprotocols/site_to_site_vpn.py

@@ -22,8 +22,11 @@ write registers/dereferences the device in the relevant site configs. The
 round-trip is intent-preserving even where the stored shape differs.
 
 In scope: overlay participation (role, hubs + default route, subnets),
-overlay exclusions (flow-level membership carve-outs — local breakout), and
-peer status. Overlay *membership* — which flows are in the overlay at all
+overlay exclusions (flow-level membership carve-outs — local breakout),
+peer status, and observed overlay path quality per local uplink
+(``get_vpn_path_metrics`` — the *tunnel* quantity, distinct from the
+underlay probe metrics on ``Router.get_wan_path_metrics``; see SPLITS.md).
+Overlay *membership* — which flows are in the overlay at all
 (role, hubs + default route, subnets, exclusions) — lives here; path
 selection *within* a domain (e.g. which overlay uplink, or which internet
 uplink) lives in ``sdwan_policy_manager``.
@@ -43,6 +46,7 @@ from testprotocols.models.sdwan_appliance import (
     SiteToSiteVpnConfig,
     VpnPeerStatus,
 )
+from testprotocols.models.wan_edge import PathMetrics
 
 
 @runtime_checkable
@@ -88,3 +92,24 @@ class SiteToSiteVpn(Protocol):
         unchanged by the driver.
         """
         ...
+
+    def get_vpn_path_metrics(
+        self, timespan_s: int, peer: str | None = None
+    ) -> dict[str, PathMetrics]:
+        """Return observed overlay path quality per local uplink.
+
+        Keyed by local uplink name (``PathMetrics.link_name`` repeats the
+        key); aggregated over every overlay peer, or over the single peer
+        named by *peer* (its testbed-level site name, as ``get_vpn_peers``
+        reports it). This is the **tunnel** quantity — the path quality the
+        product's own overlay steering evaluates — not the underlay probe
+        metrics of ``Router.get_wan_path_metrics``.
+
+        *timespan_s* is explicit because products report this as a windowed
+        aggregate: the caller owns the freshness/staleness trade and sizes
+        its observation intervals beyond the product's reporting lag. An
+        uplink absent from the result carried no measured overlay path in
+        the window — presence is itself evidence a tunnel rode that uplink.
+        Empty dict when the device participates in no overlay.
+        """
+        ...

testprotocols-0.9.0/src/testprotocols/uplink_ports.py

@@ -0,0 +1,54 @@
+"""Uplink switch-port wiring — boundary view of a WAN edge's declared uplink ports.
+
+A testbed that instruments a WAN uplink (splicing an impairment path into it,
+re-VLANing the port that carries it) needs to know **which managed-switch
+ports carry which uplink**. That is a declared-topology fact the device's
+driver resolves from its own configuration — a boundary view in the
+``DeviceInfo`` / ``PlacementPipe`` family, not behaviour.
+
+The placement split carries over: the WAN-edge device declares which ports
+carry its uplinks (**topology**, this view — the ``PlacementPipe`` analogue),
+while the switch's ``PlacementPorts`` remains the **write authorization** for
+re-VLANing anything. The two declarations stay independent, owned by the two
+resources they describe.
+
+One uplink maps to a *tuple* of port references — one per chassis / redundant
+pair member — because a warm-spare pair shares its WAN segments: moving one
+member's port and not its twin's splits the segment, so a consumer must see
+the full member set to act on an uplink coherently.
+
+The **as-found VLAN is deliberately absent**: port VLANs drift, so a recorded
+value would rot; a consumer captures the as-found state live from the switch
+at the moment it writes.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from dataclasses import dataclass
+from typing import Protocol, runtime_checkable
+
+
+@dataclass(frozen=True)
+class UplinkPortRef:
+    """One switch port carrying (one member's leg of) a WAN uplink."""
+
+    member: str
+    """Device (chassis / redundant-pair member) whose WAN port this is."""
+
+    switch: str
+    """Name of the managed switch carrying the port."""
+
+    port: str
+    """The switch port carrying this member's uplink."""
+
+
+@runtime_checkable
+class UplinkPorts(Protocol):
+    """Abstract contract for a WAN edge's declared uplink→switch-port wiring."""
+
+    @property
+    def wan_ports(self) -> Mapping[str, tuple[UplinkPortRef, ...]]:
+        """Uplink name → the switch ports carrying that uplink, one entry per
+        chassis / pair member; empty mapping when the wiring is undeclared."""
+        ...

{testprotocols-0.8.0 → testprotocols-0.9.0/src/testprotocols.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testprotocols
-Version: 0.8.0
+Version: 0.9.0
 Summary: Common Test Resource Layer — capability and device protocols for telco testing.
 Author-email: Alottabits <rjvisser@alottabits.com>
 Maintainer-email: Alottabits <rjvisser@alottabits.com>

{testprotocols-0.8.0 → testprotocols-0.9.0}/src/testprotocols.egg-info/SOURCES.txt

@@ -81,6 +81,7 @@ src/testprotocols/threat_prevention.py
 src/testprotocols/tr069_client.py
 src/testprotocols/tr069_server.py
 src/testprotocols/traffic_shaping.py
+src/testprotocols/uplink_ports.py
 src/testprotocols/upnp_client.py
 src/testprotocols/vlan_client.py
 src/testprotocols/wan_link_admin.py

{testprotocols-0.8.0 → testprotocols-0.9.0}/tests/test_boundary_capability_templates.py

@@ -13,6 +13,7 @@ from testprotocols.config_ownership import ConfigOwnership
 from testprotocols.device_info import DeviceInfo
 from testprotocols.network_attachment import NetworkAttachment
 from testprotocols.placement import PlacementPipe, PlacementPorts
+from testprotocols.uplink_ports import UplinkPortRef, UplinkPorts
 
 
 def test_network_attachment_members() -> None:
@@ -35,6 +36,27 @@ def test_config_ownership_members() -> None:
     assert protocol_attrs(ConfigOwnership) == {"manages_network"}
 
 
+def test_uplink_ports_members() -> None:
+    assert protocol_attrs(UplinkPorts) == {"wan_ports"}
+
+
+def test_uplink_ports_view_satisfies_runtime_check() -> None:
+    """A driver view exposing the wiring mapping satisfies the runtime check."""
+
+    class _View:
+        @property
+        def wan_ports(self) -> dict[str, tuple[UplinkPortRef, ...]]:
+            return {
+                "wan1": (
+                    UplinkPortRef(member="edge-a", switch="dist-1", port="7"),
+                    UplinkPortRef(member="edge-b", switch="dist-1", port="8"),
+                ),
+            }
+
+    assert isinstance(_View(), UplinkPorts)
+    assert _View().wan_ports["wan1"][0].switch == "dist-1"
+
+
 def test_runtime_checkable_with_plain_attributes() -> None:
     """A driver view exposing plain attributes satisfies the runtime check."""