testprotocols 0.2.0__tar.gz → 0.3.0__tar.gz

{testprotocols-0.2.0/src/testprotocols.egg-info → testprotocols-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testprotocols
-Version: 0.2.0
+Version: 0.3.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.2.0 → testprotocols-0.3.0}/pyproject.toml

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

{testprotocols-0.2.0 → testprotocols-0.3.0}/src/testprotocols/sdwan_policy_manager.py

@@ -7,9 +7,12 @@ Firewall-rule administration is **not** here — it moved to the dedicated
 ``l3_firewall`` / ``l7_firewall`` capabilities (coherent-domain split; see
 SPLITS.md). Typed path steering (``set_uplink_selection`` /
 ``get_uplink_selection`` over ordered ``UplinkSelectionRule``s; performance
-classes reuse ``SLAPolicy`` by name) landed 2026-06-12; ``apply_policy``
-remains the generic escape hatch for vendor-shaped policies beyond that
-surface. Application-match steering grows on evidence.
+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.
 """
 
 from __future__ import annotations
@@ -48,6 +51,25 @@ class SdwanPolicyManager(Protocol):
         """Return application flows observed in the last *since_s* seconds."""
         ...
 
+    def get_default_uplink(self) -> str:
+        """Return the name of the network's default (primary) uplink.
+
+        The default uplink carries all default-routed traffic that no
+        uplink-selection rule steers elsewhere — e.g. ``"wan1"``. Vendor
+        drivers map this to their primary-uplink notion.
+        """
+        ...
+
+    def set_default_uplink(self, uplink: str) -> None:
+        """Set the network's default (primary) uplink to *uplink*.
+
+        Changes only which uplink carries default-routed traffic; the
+        ordered uplink-selection rules (``set_uplink_selection``) are left
+        untouched. Drivers reject names the product cannot express (e.g.
+        an uplink the appliance does not have) rather than approximating.
+        """
+        ...
+
     def set_uplink_selection(self, rules: list[UplinkSelectionRule]) -> None:
         """Replace the ordered uplink-selection rule list with *rules*.
 

{testprotocols-0.2.0 → testprotocols-0.3.0}/src/testprotocols/spanning_tree.py

@@ -21,7 +21,7 @@ class SpanningTree(Protocol):
         ...
 
     def set_bridge_priority(self, priority: int) -> None:
-        """Set the bridge priority (0–61440, in steps of 4096 per IEEE 802.1D)."""
+        """Set the bridge priority (0-61440, in steps of 4096 per IEEE 802.1D)."""
         ...
 
     def set_port_config(self, config: StpPortConfig) -> None:

{testprotocols-0.2.0 → testprotocols-0.3.0/src/testprotocols.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testprotocols
-Version: 0.2.0
+Version: 0.3.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.2.0 → testprotocols-0.3.0}/tests/test_device_types.py

@@ -10,7 +10,6 @@ inventory-string -> Protocol binding and the per-archetype capability set
 from __future__ import annotations
 
 import pytest
-
 from testprotocols.devices import DeviceTypeSpec, all_device_types, get_device_type
 from testprotocols.devices.base import BaseDeviceProtocol
 from testprotocols.devices.client import (
@@ -22,12 +21,12 @@ from testprotocols.devices.client import (
 from testprotocols.devices.cpe import CpeDevice
 from testprotocols.devices.infra import AcsDevice, ProvisionerDevice, TftpDevice
 from testprotocols.devices.sdwan import SdwanApplianceDevice, SdwanRouterDevice
+from testprotocols.devices.switch import L2Switch, L3Switch, L3SwitchRouted
 from testprotocols.devices.traffic import (
     IperfTrafficGeneratorDevice,
     TrafficControllerDevice,
 )
 from testprotocols.devices.voice import SipPhoneDevice, SipServerDevice
-from testprotocols.devices.switch import L2Switch, L3Switch, L3SwitchRouted
 from testprotocols.devices.wan import WanServerDevice
 
 _ALL_ARCHETYPES = (
@@ -455,7 +454,9 @@ def test_cpe_full_firewall_surface() -> None:
 
 def test_devices_without_firewall() -> None:
     """These archetypes must not pull in any of the firewall capabilities."""
-    firewall_attrs = ("packet_filter", "firewall", "nat", "port_forwarding", "conntrack", "firewall_zones")
+    firewall_attrs = (
+        "packet_filter", "firewall", "nat", "port_forwarding", "conntrack", "firewall_zones"
+    )
     for archetype in (
         TftpDevice,
         WlanClientDevice,

{testprotocols-0.2.0 → testprotocols-0.3.0}/tests/test_sdwan_appliance_models.py

@@ -10,7 +10,6 @@ from __future__ import annotations
 from enum import StrEnum
 
 import pytest
-
 from testprotocols.models.sdwan_appliance import (
     ApplicationCategory,
     BgpConfig,
@@ -18,20 +17,20 @@ from testprotocols.models.sdwan_appliance import (
     BgpPeerStatus,
     BgpSessionState,
     ContentCategory,
-    FlowMatch,
-    L3Rule,
-    L7MatchType,
-    L7Rule,
-    RuleAction,
-    RuleProtocol,
     DhcpLease,
     DhcpMode,
     DhcpOption,
     DhcpOptionType,
+    FlowMatch,
     IntrusionConfig,
     IntrusionMode,
     IntrusionSensitivity,
+    L3Rule,
+    L7MatchType,
+    L7Rule,
     MalwareMode,
+    RuleAction,
+    RuleProtocol,
     SecurityAction,
     SecurityEvent,
     ShapingPriority,
@@ -126,7 +125,8 @@ def test_shaping_rule_uses_normalized_vocabulary() -> None:
         priority=ShapingPriority.LOW,
     )
     assert rule.priority == "low"
-    assert ShapingRule(name="x", match_type=L7MatchType.HOST, value="1.2.3.4").priority is ShapingPriority.NORMAL
+    default = ShapingRule(name="x", match_type=L7MatchType.HOST, value="1.2.3.4")
+    assert default.priority is ShapingPriority.NORMAL
 
 
 def test_uplink_state_and_status() -> None:
@@ -144,7 +144,10 @@ def test_syslog_role_and_server() -> None:
 
 
 def test_threat_prevention_vocabularies() -> None:
-    for enum_cls in (IntrusionMode, IntrusionSensitivity, MalwareMode, SecurityAction, ThreatCategory):
+    vocabularies = (
+        IntrusionMode, IntrusionSensitivity, MalwareMode, SecurityAction, ThreatCategory
+    )
+    for enum_cls in vocabularies:
         assert issubclass(enum_cls, StrEnum)
     assert {m.value for m in IntrusionMode} == {"disabled", "detection", "prevention"}
     assert {s.value for s in IntrusionSensitivity} == {"low", "medium", "high"}

{testprotocols-0.2.0 → testprotocols-0.3.0}/tests/test_switch_models.py

@@ -66,6 +66,7 @@ def test_switch_records() -> None:
         AccessPolicy,
         AccessPolicyType,
         FhsBinding,
+        LinkAggregationGroup,
         LinkState,
         LldpNeighbor,
         NtpServer,
@@ -74,12 +75,10 @@ def test_switch_records() -> None:
         PortStatusEntry,
         QosRule,
         StormControlConfig,
-        StormControlType,
         StpPortConfig,
         SwitchAclRule,
         SwitchPort,
         VlanDef,
-        LinkAggregationGroup,
     )
 
     p = SwitchPort(name="1", mode="access")  # type: ignore[arg-type]

{testprotocols-0.2.0 → testprotocols-0.3.0}/tests/test_switch_routing_models.py

@@ -43,7 +43,13 @@ def test_switch_routing_records() -> None:
         RoutedInterface,
     )
 
-    ri = RoutedInterface(name="vlan10", mode=InterfaceMode.SVI, ip_address="10.0.10.1", subnet="10.0.10.0/24", vlan_id=10)
+    ri = RoutedInterface(
+        name="vlan10",
+        mode=InterfaceMode.SVI,
+        ip_address="10.0.10.1",
+        subnet="10.0.10.0/24",
+        vlan_id=10,
+    )
     assert ri.vlan_id == 10
     d = InterfaceDhcpConfig(interface="vlan10")
     assert d.mode == "disabled" and d.relay_targets == []
@@ -51,5 +57,7 @@ def test_switch_routing_records() -> None:
     assert o.version == "v2" and o.interfaces == []
     oi = OspfInterfaceSettings(interface="vlan10", area="0.0.0.0")
     assert oi.passive is False
-    g = RedundancyGroup(group_id=1, virtual_ip="10.0.10.254", role=RedundancyRole.PRIMARY, interface="vlan10")
+    g = RedundancyGroup(
+        group_id=1, virtual_ip="10.0.10.254", role=RedundancyRole.PRIMARY, interface="vlan10"
+    )
     assert g.virtual_ip == "10.0.10.254"

{testprotocols-0.2.0 → testprotocols-0.3.0}/tests/test_wan_edge_templates.py

@@ -60,6 +60,8 @@ PROTOCOLS = [
             "get_application_flows",
             "set_uplink_selection",
             "get_uplink_selection",
+            "get_default_uplink",
+            "set_default_uplink",
         },
     ),
     (

{testprotocols-0.2.0 → testprotocols-0.3.0}/src/testprotocols/models/__init__.py

@@ -13,6 +13,12 @@ from testprotocols.models.firewall import (
     ZonePolicy,
 )
 from testprotocols.models.impairment import ImpairmentProfile
+from testprotocols.models.l2_common import (
+    MacTableEntry,
+    StpGuard,
+    StpMode,
+    StpPortState,
+)
 from testprotocols.models.multicast import (
     McastGroup,
     McastSource,
@@ -22,6 +28,12 @@ from testprotocols.models.multicast import (
 from testprotocols.models.networking import HTTPResult, ICMPPacketData, IPAddresses
 from testprotocols.models.packets import RIPv2PacketData
 from testprotocols.models.qoe import MeasurementSpec, QoEResult
+from testprotocols.models.radius import (
+    RadiusAccountingRecord,
+    RadiusServerConfig,
+    RadiusSession,
+    RadiusUser,
+)
 from testprotocols.models.sdwan_appliance import (
     ApplicationCategory,
     BgpConfig,
@@ -69,12 +81,6 @@ from testprotocols.models.sdwan_appliance import (
     VpnRole,
     VpnSubnet,
 )
-from testprotocols.models.l2_common import (
-    MacTableEntry,
-    StpGuard,
-    StpMode,
-    StpPortState,
-)
 from testprotocols.models.switch import (
     AccessPolicy,
     AccessPolicyType,
@@ -105,14 +111,6 @@ from testprotocols.models.switch import (
     SwitchPort,
     VlanDef,
 )
-from testprotocols.models.radius import (
-    RadiusAccountingRecord,
-    RadiusServerConfig,
-    RadiusSession,
-    RadiusUser,
-)
-from testprotocols.models.tr069 import CpeConnectionStatus
-from testprotocols.models.traffic import TrafficResult, TrafficSpec
 from testprotocols.models.switch_routing import (
     InterfaceDhcpConfig,
     InterfaceMode,
@@ -123,6 +121,8 @@ from testprotocols.models.switch_routing import (
     RedundancyRole,
     RoutedInterface,
 )
+from testprotocols.models.tr069 import CpeConnectionStatus
+from testprotocols.models.traffic import TrafficResult, TrafficSpec
 from testprotocols.models.wan_edge import (
     AppFlow,
     LinkHealthReport,
@@ -151,114 +151,65 @@ from testprotocols.models.wifi import (
 )
 
 __all__ = [
-    # l2_common
-    "MacTableEntry",
-    "StpGuard",
-    "StpMode",
-    "StpPortState",
     # switch
     "AccessPolicy",
     "AccessPolicyType",
     "AclDirection",
     "AggregationMode",
-    "BindingSource",
-    "DiscoveryProtocol",
-    "Duplex",
-    "FhsBinding",
-    "FhsScope",
-    "FhsTrustState",
-    "LinkAggregationGroup",
-    "LinkState",
-    "LldpNeighbor",
-    "NtpServer",
-    "PoePortStatus",
-    "PoePriority",
-    "PoeStatus",
-    "PortAdminState",
-    "PortMode",
-    "PortStatusEntry",
-    "QosRule",
-    "QosTrustMode",
-    "StormControlConfig",
-    "StormControlType",
-    "StpPortConfig",
-    "SwitchAclRule",
-    "SwitchPort",
-    "VlanDef",
-    # switch_routing
-    "InterfaceDhcpConfig",
-    "InterfaceMode",
-    "OspfConfig",
-    "OspfInterfaceSettings",
-    "OspfVersion",
-    "RedundancyGroup",
-    "RedundancyRole",
-    "RoutedInterface",
     # wan_edge
     "AppFlow",
+    # sdwan_appliance
+    "ApplicationCategory",
+    "BgpConfig",
+    "BgpNeighbor",
+    "BgpPeerStatus",
+    "BgpSessionState",
+    "BindingSource",
     # firewall
     "Connection",
     "ConntrackStats",
+    "ContentCategory",
     # tr069
     "CpeConnectionStatus",
     # dhcp
     "DHCPTraceData",
     "DHCPV6TraceData",
+    "DhcpLease",
+    "DhcpMode",
+    "DhcpOption",
+    "DhcpOptionType",
+    "DhcpReservation",
+    "DiscoveryProtocol",
+    "Duplex",
+    "FhsBinding",
+    "FhsScope",
+    "FhsTrustState",
     "FirewallRule",
+    "FlowMatch",
     # networking
     "HTTPResult",
     "ICMPPacketData",
     "IPAddresses",
     # impairment
     "ImpairmentProfile",
-    # sdwan_appliance
-    "ApplicationCategory",
-    "BgpConfig",
-    "BgpNeighbor",
-    "BgpPeerStatus",
-    "BgpSessionState",
-    "ContentCategory",
-    "DhcpLease",
-    "DhcpMode",
-    "DhcpOption",
-    "DhcpOptionType",
-    "DhcpReservation",
-    "FlowMatch",
+    # switch_routing
+    "InterfaceDhcpConfig",
+    "InterfaceMode",
     "IntrusionConfig",
     "IntrusionMode",
     "IntrusionSensitivity",
     "L3Rule",
     "L7MatchType",
     "L7Rule",
-    "MalwareConfig",
-    "MalwareMode",
-    "NatInboundAllow",
-    "OneToManyNatRule",
-    "OneToOneNatRule",
-    "PortForwardRule",
-    "RuleAction",
-    "RuleProtocol",
-    "SecurityAction",
-    "SecurityEvent",
-    "ShapingPriority",
-    "ShapingRule",
-    "SiteToSiteVpnConfig",
-    "StaticRoute",
-    "SteeringScope",
-    "SyslogRole",
-    "SyslogServer",
-    "ThreatCategory",
-    "UplinkSelectionRule",
-    "UplinkState",
-    "UplinkStatus",
-    "VlanConfig",
-    "VpnHub",
-    "VpnPeerState",
-    "VpnPeerStatus",
-    "VpnRole",
-    "VpnSubnet",
+    "LinkAggregationGroup",
     "LinkHealthReport",
+    "LinkState",
     "LinkStatus",
+    "LldpNeighbor",
+    # l2_common
+    "MacTableEntry",
+    "MalwareConfig",
+    "MalwareMode",
     # multicast
     "McastGroup",
     "McastSource",
@@ -266,10 +217,26 @@ __all__ = [
     "MeasurementSpec",
     "MulticastGroupRecord",
     "MulticastGroupRecordType",
+    "NatInboundAllow",
     "NatRule",
+    "NtpServer",
+    "OneToManyNatRule",
+    "OneToOneNatRule",
+    "OspfConfig",
+    "OspfInterfaceSettings",
+    "OspfVersion",
     "PathMetrics",
+    "PoePortStatus",
+    "PoePriority",
+    "PoeStatus",
+    "PortAdminState",
+    "PortForwardRule",
     "PortMapping",
+    "PortMode",
+    "PortStatusEntry",
     "QoEResult",
+    "QosRule",
+    "QosTrustMode",
     # packets
     "RIPv2PacketData",
     # radius
@@ -277,14 +244,47 @@ __all__ = [
     "RadiusServerConfig",
     "RadiusSession",
     "RadiusUser",
+    "RedundancyGroup",
+    "RedundancyRole",
     "RouteEntry",
     "RouteOrigin",
+    "RoutedInterface",
+    "RuleAction",
+    "RuleProtocol",
     "SLAPolicy",
+    "SecurityAction",
+    "SecurityEvent",
+    "ShapingPriority",
+    "ShapingRule",
+    "SiteToSiteVpnConfig",
+    "StaticRoute",
+    "SteeringScope",
+    "StormControlConfig",
+    "StormControlType",
+    "StpGuard",
+    "StpMode",
+    "StpPortConfig",
+    "StpPortState",
+    "SwitchAclRule",
+    "SwitchPort",
+    "SyslogRole",
+    "SyslogServer",
+    "ThreatCategory",
     # traffic
     "TrafficResult",
     "TrafficShapingRule",
     "TrafficSpec",
+    "UplinkSelectionRule",
+    "UplinkState",
+    "UplinkStatus",
     "VPNPeerStatus",
+    "VlanConfig",
+    "VlanDef",
+    "VpnHub",
+    "VpnPeerState",
+    "VpnPeerStatus",
+    "VpnRole",
+    "VpnSubnet",
     # wifi
     "WifiAcl",
     "WifiBssConfig",