Add MPLS label, NOPEER community, and route oscillation tests

- Add MPLS label tests (LABEL-001 to LABEL-010) for RFC 3107
  - Label encoding in MP_REACH_NLRI with SAFI=4
  - 3-byte label encoding with BOS bit
  - Label stack depth, reserved ranges, withdrawal values
- Add NOPEER community tests (NOPEER-001 to NOPEER-005) for RFC 3765
  - NOPEER well-known community value 0xFFFFFF04
  - Route scope control for bilateral peers
  - NOPEER vs NO_EXPORT comparison
- Add route oscillation tests (OSCIL-001 to OSCIL-005) for RFC 3345
  - Type I/II oscillation conditions
  - MED non-deterministic ordering
  - Route reflection and confederation considerations
- Add constants for MPLS labels, NOPEER community, and oscillation types
- Update test category count to 32
- Update README with new test categories and RFC references

Author: daedalus

README.md

@@ -646,6 +646,35 @@ Tests for Route Refresh Capability per RFC 2918:
 - RFR-009: Route Refresh AFI/SAFI Not Advertised
 - RFR-010: Route Refresh End-of-RIB
 
+### mpls_labels
+Tests for MPLS Label Distribution in BGP per RFC 3107:
+- LABEL-001: MPLS Label in MP_REACH_NLRI SAFI-4
+- LABEL-002: MPLS Label 3-Byte Encoding
+- LABEL-003: MPLS Label Stack Depth
+- LABEL-004: MPLS Label Reserved Range 0-15
+- LABEL-005: MPLS Label Implicit NULL
+- LABEL-006: MPLS Label Withdrawal Value
+- LABEL-007: MPLS Label Next Hop Self
+- LABEL-008: MPLS Label Preservation on Redistribute
+- LABEL-009: MPLS Label NLRI Length Field
+- LABEL-010: MPLS Label Capability Advertisement
+
+### nopeer
+Tests for NOPEER Community per RFC 3765:
+- NOPEER-001: NOPEER Community Value (0xFFFFFF04)
+- NOPEER-002: NOPEER Route Scope Control
+- NOPEER-003: NOPEER vs NO_EXPORT Comparison
+- NOPEER-004: NOPEER Well-Known Transitive
+- NOPEER-005: NOPEER Filtering Implementation
+
+### route_oscillation
+Tests for BGP Route Oscillation Conditions per RFC 3345:
+- OSCIL-001: Type I Oscillation with Route Reflection
+- OSCIL-002: Type I Oscillation with Confederation
+- OSCIL-003: MED Non-Deterministic Ordering
+- OSCIL-004: Type II Oscillation Conditions
+- OSCIL-005: MED Comparison Same AS Only
+
 ## References
 
 - [RFC 4271 - A Border Gateway Protocol 4 (BGP-4)](https://www.rfc-editor.org/rfc/rfc4271)
@@ -668,6 +697,8 @@ Tests for Route Refresh Capability per RFC 2918:
 - [RFC 4364 - BGP/MPLS IP Virtual Private Networks (VPNs)](https://www.rfc-editor.org/rfc/rfc4364)
 - [RFC 2842 - Capabilities Advertisement with BGP-4](https://www.rfc-editor.org/rfc/rfc2842)
 - [RFC 5492 - Extensions to BGP-4 for Capabilities Advertisement](https://www.rfc-editor.org/rfc/rfc5492)
+- [RFC 3107 - Carrying Label Information in BGP-4](https://www.rfc-editor.org/rfc/rfc3107)
+- [RFC 3765 - NOPEER Community for BGP Route Scope Control](https://www.rfc-editor.org/rfc/rfc3765)
 - [RFC 1105 - BGP (obsolete)](https://www.rfc-editor.org/rfc/rfc1105)
 - [RFC 1163 - BGP-2 (obsolete)](https://www.rfc-editor.org/rfc/rfc1163)
 - [RFC 1267 - BGP-3 (obsolete)](https://www.rfc-editor.org/rfc/rfc1267)

src/bgp_test_framework/constants.py

@@ -288,3 +288,34 @@
 CAPABILITY_ERROR_SUBCODES = {
     "UNSUPPORTED_CAPABILITY": 7,
 }
+
+MPLS_LABEL_SAFI = 4
+MPLS_LABEL_ENCODING_LENGTH = 3
+MPLS_LABEL_STACK_DEPTH_MAX = 4
+MPLS_LABEL_WITHDRAWAL_VALUE = 0x800000
+
+WELL_KNOWN_COMMUNITIES_RFC3765 = {
+    "NO_EXPORT": 0xFFFFFF01,
+    "NO_ADVERTISE": 0xFFFFFF02,
+    "NO_EXPORT_SUBCONFED": 0xFFFFFF03,
+    "NOPEER": 0xFFFFFF04,
+}
+
+NOPEER_COMMUNITY = 0xFFFFFF04
+
+OSCILLATION_TYPES = {
+    "TYPE_I": 1,
+    "TYPE_II": 2,
+}
+
+MED_COMPARISON_RULES = {
+    "SAME_NEIGHBORING_AS": 0,
+    "NON_COMPARABLE": 255,
+}
+
+DAMPING_CALCULATION = {
+    "STABILITYFIGURE_INITIAL": 0,
+    "WITHDRAWAL_PENALTY": 1000,
+    "READVERTISEMENT_PENALTY": 500,
+    "ATTRCHANGE_PENALTY": 500,
+}

src/bgp_test_framework/tests.py

@@ -51,6 +51,9 @@ class TestCategory(Enum):
     VPN = "vpn"
     CAPABILITIES = "capabilities"
     ROUTE_REFRESH = "route_refresh"
+    MPLS_LABELS = "mpls_labels"
+    NOPEER = "nopeer"
+    ROUTE_OSCILLATION = "route_oscillation"
 
 
 @dataclass
@@ -2416,3 +2419,144 @@ def get_tests() -> List[TestCase]:
                 description="End-of-RIB marker after Route Refresh - RFC 2918",
             ),
         ]
+
+
+class MPLSLabelTests:
+    @staticmethod
+    def get_tests() -> List[TestCase]:
+        return [
+            TestCase(
+                test_id="LABEL-001",
+                name="MPLS Label in MP_REACH_NLRI SAFI-4",
+                category=TestCategory.MPLS_LABELS,
+                description="MP_REACH_NLRI with SAFI=4 for label distribution - RFC 3107",
+            ),
+            TestCase(
+                test_id="LABEL-002",
+                name="MPLS Label 3-Byte Encoding",
+                category=TestCategory.MPLS_LABELS,
+                description="Label encoded as 3 octets: 20-bit value + BOS bit - RFC 3107 Section 3",
+            ),
+            TestCase(
+                test_id="LABEL-003",
+                name="MPLS Label Stack Depth",
+                category=TestCategory.MPLS_LABELS,
+                description="Multiple labels for label stack encoding - RFC 3107 Section 3",
+            ),
+            TestCase(
+                test_id="LABEL-004",
+                name="MPLS Label Reserved Range 0-15",
+                category=TestCategory.MPLS_LABELS,
+                description="Labels 0-15 are reserved per RFC 3032 - RFC 3107",
+            ),
+            TestCase(
+                test_id="LABEL-005",
+                name="MPLS Label Implicit NULL",
+                category=TestCategory.MPLS_LABELS,
+                description="Label 3 is Implicit NULL - RFC 3107",
+            ),
+            TestCase(
+                test_id="LABEL-006",
+                name="MPLS Label Withdrawal Value",
+                category=TestCategory.MPLS_LABELS,
+                description="Withdrawal NLRI label set to 0x800000 - RFC 3107 Section 3",
+            ),
+            TestCase(
+                test_id="LABEL-007",
+                name="MPLS Label Next Hop Self",
+                category=TestCategory.MPLS_LABELS,
+                description="Label assigned by Next Hop router - RFC 3107 Section 3",
+            ),
+            TestCase(
+                test_id="LABEL-008",
+                name="MPLS Label Preservation on Redistribute",
+                category=TestCategory.MPLS_LABELS,
+                description="Labels must not change unless Next Hop changes - RFC 3107 Section 3",
+            ),
+            TestCase(
+                test_id="LABEL-009",
+                name="MPLS Label NLRI Length Field",
+                category=TestCategory.MPLS_LABELS,
+                description="Length field indicates prefix bits plus label bits - RFC 3107 Section 3",
+            ),
+            TestCase(
+                test_id="LABEL-010",
+                name="MPLS Label Capability Advertisement",
+                category=TestCategory.MPLS_LABELS,
+                description="MP_EXT capability required for label SAFI - RFC 3107 Section 5",
+            ),
+        ]
+
+
+class NOPEERCommunityTests:
+    @staticmethod
+    def get_tests() -> List[TestCase]:
+        return [
+            TestCase(
+                test_id="NOPEER-001",
+                name="NOPEER Community Value",
+                category=TestCategory.NOPEER,
+                description="NOPEER well-known community value 0xFFFFFF04 - RFC 3765 Section 4",
+            ),
+            TestCase(
+                test_id="NOPEER-002",
+                name="NOPEER Route Scope Control",
+                category=TestCategory.NOPEER,
+                description="NOPEER restricts advertisement to bilateral peers - RFC 3765 Section 2",
+            ),
+            TestCase(
+                test_id="NOPEER-003",
+                name="NOPEER vs NO_EXPORT Comparison",
+                category=TestCategory.NOPEER,
+                description="NOPEER allows advertisement to provider but not peer - RFC 3765",
+            ),
+            TestCase(
+                test_id="NOPEER-004",
+                name="NOPEER Well-Known Transitive",
+                category=TestCategory.NOPEER,
+                description="NOPEER is well-known and transitive - RFC 3765 Section 2",
+            ),
+            TestCase(
+                test_id="NOPEER-005",
+                name="NOPEER Filtering Implementation",
+                category=TestCategory.NOPEER,
+                description="Receiving AS may filter based on peering relationship - RFC 3765 Section 2",
+            ),
+        ]
+
+
+class RouteOscillationTests:
+    @staticmethod
+    def get_tests() -> List[TestCase]:
+        return [
+            TestCase(
+                test_id="OSCIL-001",
+                name="Type I Oscillation with Route Reflection",
+                category=TestCategory.ROUTE_OSCILLATION,
+                description="Type I churn requires single-level RR + MED - RFC 3345 Section 2.1",
+            ),
+            TestCase(
+                test_id="OSCIL-002",
+                name="Type I Oscillation with Confederation",
+                category=TestCategory.ROUTE_OSCILLATION,
+                description="Type I churn with AS confederations - RFC 3345 Section 2.2",
+            ),
+            TestCase(
+                test_id="OSCIL-003",
+                name="MED Non-Deterministic Ordering",
+                category=TestCategory.ROUTE_OSCILLATION,
+                description="Non-deterministic path ordering can cause loops - RFC 3345 Section 2",
+            ),
+            TestCase(
+                test_id="OSCIL-004",
+                name="Type II Oscillation Conditions",
+                category=TestCategory.ROUTE_OSCILLATION,
+                description="Type II oscillation conditions - RFC 3345 Section 3",
+            ),
+            TestCase(
+                test_id="OSCIL-005",
+                name="MED Comparison Same AS Only",
+                category=TestCategory.ROUTE_OSCILLATION,
+                description="MED comparable only between routes from same neighboring AS - RFC 3345",
+            ),
+        ]

tests/unit/test_tests.py

@@ -192,7 +192,7 @@ def test_collision_tests(self):
 
 class TestTestCategories:
     def test_all_categories_defined(self):
-        assert len(TestCategory) == 29
+        assert len(TestCategory) == 32
         assert TestCategory.MESSAGE_HEADER.value == "message_header"
         assert TestCategory.OPEN_MESSAGE.value == "open_message"
         assert TestCategory.UPDATE_MESSAGE.value == "update_message"