network-sandbox-engine 1.1.0__tar.gz → 2.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/PKG-INFO +13 -10
  2. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/README.md +5 -6
  3. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/network_sandbox_engine.egg-info/PKG-INFO +13 -10
  4. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/network_sandbox_engine.egg-info/SOURCES.txt +6 -2
  5. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/network_sandbox_engine.egg-info/requires.txt +6 -2
  6. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/__init__.py +3 -1
  7. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/cli/runner.py +31 -58
  8. network_sandbox_engine-2.0.0/nse/core/mock_listener.py +132 -0
  9. network_sandbox_engine-2.0.0/nse/core/naming.py +42 -0
  10. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/core/netns_controller.py +81 -61
  11. network_sandbox_engine-2.0.0/nse/core/pipeline.py +353 -0
  12. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/core/rule_engine.py +26 -8
  13. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/core/scapy_injector.py +12 -10
  14. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/core/sniffer.py +1 -2
  15. network_sandbox_engine-2.0.0/nse/core/trace_harvester.py +224 -0
  16. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/core/utils.py +5 -8
  17. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/models/test_request.py +20 -42
  18. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/models/trace_event.py +1 -18
  19. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/pyproject.toml +27 -4
  20. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/tests/test_netns.py +6 -77
  21. network_sandbox_engine-2.0.0/tests/test_oracle_e2e.py +88 -0
  22. network_sandbox_engine-2.0.0/tests/test_trace_parser.py +51 -0
  23. network_sandbox_engine-1.1.0/nse/core/pipeline.py +0 -416
  24. network_sandbox_engine-1.1.0/nse/models/base.py +0 -22
  25. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/LICENSE +0 -0
  26. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/network_sandbox_engine.egg-info/dependency_links.txt +0 -0
  27. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/network_sandbox_engine.egg-info/entry_points.txt +0 -0
  28. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/network_sandbox_engine.egg-info/top_level.txt +0 -0
  29. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/cli/__init__.py +0 -0
  30. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/core/__init__.py +0 -0
  31. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/nse/models/__init__.py +0 -0
  32. {network_sandbox_engine-1.1.0 → network_sandbox_engine-2.0.0}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: network-sandbox-engine
3
- Version: 1.1.0
3
+ Version: 2.0.0
4
4
  Summary: Headless Python engine for isolated network namespace testing and PCAP assertions.
5
5
  Author: onyks
6
6
  License: MIT
@@ -8,7 +8,7 @@ Project-URL: Homepage, https://github.com/onyks-os/NetworkSandboxEngine
8
8
  Project-URL: Repository, https://github.com/onyks-os/NetworkSandboxEngine
9
9
  Project-URL: Issues, https://github.com/onyks-os/NetworkSandboxEngine/issues
10
10
  Keywords: networking,namespace,testing,nftables,pcap,scapy
11
- Classifier: Development Status :: 5 - Production/Stable
11
+ Classifier: Development Status :: 4 - Beta
12
12
  Classifier: Intended Audience :: Developers
13
13
  Classifier: License :: OSI Approved :: MIT License
14
14
  Classifier: Operating System :: POSIX :: Linux
@@ -22,18 +22,22 @@ Requires-Python: >=3.10
22
22
  Description-Content-Type: text/markdown
23
23
  License-File: LICENSE
24
24
  Requires-Dist: scapy>=2.5.0
25
+ Requires-Dist: pydantic>=2.0.0
25
26
  Provides-Extra: cli
26
- Requires-Dist: pydantic>=2.0.0; extra == "cli"
27
27
  Requires-Dist: pyyaml>=6.0; extra == "cli"
28
28
  Provides-Extra: gui
29
29
  Requires-Dist: fastapi>=0.111.0; extra == "gui"
30
30
  Requires-Dist: uvicorn[standard]>=0.29.0; extra == "gui"
31
31
  Requires-Dist: websockets>=12.0; extra == "gui"
32
- Requires-Dist: pydantic>=2.0.0; extra == "gui"
33
32
  Provides-Extra: dev
34
33
  Requires-Dist: pytest>=8.0.0; extra == "dev"
35
34
  Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
36
35
  Requires-Dist: ruff; extra == "dev"
36
+ Requires-Dist: import-linter; extra == "dev"
37
+ Requires-Dist: mypy; extra == "dev"
38
+ Requires-Dist: mkdocs>=1.5.0; extra == "dev"
39
+ Requires-Dist: mkdocs-material>=9.5.0; extra == "dev"
40
+ Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "dev"
37
41
  Dynamic: license-file
38
42
 
39
43
  # Network Sandbox Engine (NSE)
@@ -156,8 +160,7 @@ nse-runner --file my_tests.yaml
156
160
  git clone https://github.com/onyks-os/NetworkSandboxEngine.git
157
161
  cd NetworkSandboxEngine
158
162
  make setup # bootstrap venv + npm install
159
- make run-rootd # starts root socket daemon (requires sudo -E)
160
- make run-web # starts FastAPI web server (runs as normal user)
163
+ make run-web # starts FastAPI web server (requires root for netns)
161
164
  make frontend # starts Vite dev server on port 5173
162
165
  ```
163
166
 
@@ -190,7 +193,7 @@ NetworkSandboxEngine/
190
193
  | `-- gui_svelte/ # Svelte + Vite frontend
191
194
  |
192
195
  |-- tests/
193
- | `-- test_netns.py # 20 unit tests (2 skipped without root)
196
+ | `-- test_netns.py # 20 unit tests (2 root integration tests)
194
197
  |
195
198
  |-- pyproject.toml # Build config - packages only nse/
196
199
  |-- Makefile # make setup | test | lint | release
@@ -275,8 +278,8 @@ Output in `release/`:
275
278
 
276
279
  ```
277
280
  release/
278
- |-- network_sandbox_engine-1.1.0-py3-none-any.whl
279
- |-- network_sandbox_engine-1.1.0.tar.gz
281
+ |-- network_sandbox_engine-1.1.1-py3-none-any.whl
282
+ |-- network_sandbox_engine-1.1.1.tar.gz
280
283
  |-- Dockerfile
281
284
  |-- nse.service
282
285
  |-- SHA256SUMS
@@ -286,7 +289,7 @@ release/
286
289
  ### Native Installation with Systemd
287
290
 
288
291
  ```bash
289
- sudo pip install release/network_sandbox_engine-1.1.0-py3-none-any.whl
292
+ sudo pip install release/network_sandbox_engine-1.1.1-py3-none-any.whl
290
293
  sudo cp release/nse.service /etc/systemd/system/
291
294
  sudo systemctl daemon-reload && sudo systemctl enable --now nse
292
295
  ```
@@ -118,8 +118,7 @@ nse-runner --file my_tests.yaml
118
118
  git clone https://github.com/onyks-os/NetworkSandboxEngine.git
119
119
  cd NetworkSandboxEngine
120
120
  make setup # bootstrap venv + npm install
121
- make run-rootd # starts root socket daemon (requires sudo -E)
122
- make run-web # starts FastAPI web server (runs as normal user)
121
+ make run-web # starts FastAPI web server (requires root for netns)
123
122
  make frontend # starts Vite dev server on port 5173
124
123
  ```
125
124
 
@@ -152,7 +151,7 @@ NetworkSandboxEngine/
152
151
  | `-- gui_svelte/ # Svelte + Vite frontend
153
152
  |
154
153
  |-- tests/
155
- | `-- test_netns.py # 20 unit tests (2 skipped without root)
154
+ | `-- test_netns.py # 20 unit tests (2 root integration tests)
156
155
  |
157
156
  |-- pyproject.toml # Build config - packages only nse/
158
157
  |-- Makefile # make setup | test | lint | release
@@ -237,8 +236,8 @@ Output in `release/`:
237
236
 
238
237
  ```
239
238
  release/
240
- |-- network_sandbox_engine-1.1.0-py3-none-any.whl
241
- |-- network_sandbox_engine-1.1.0.tar.gz
239
+ |-- network_sandbox_engine-1.1.1-py3-none-any.whl
240
+ |-- network_sandbox_engine-1.1.1.tar.gz
242
241
  |-- Dockerfile
243
242
  |-- nse.service
244
243
  |-- SHA256SUMS
@@ -248,7 +247,7 @@ release/
248
247
  ### Native Installation with Systemd
249
248
 
250
249
  ```bash
251
- sudo pip install release/network_sandbox_engine-1.1.0-py3-none-any.whl
250
+ sudo pip install release/network_sandbox_engine-1.1.1-py3-none-any.whl
252
251
  sudo cp release/nse.service /etc/systemd/system/
253
252
  sudo systemctl daemon-reload && sudo systemctl enable --now nse
254
253
  ```
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: network-sandbox-engine
3
- Version: 1.1.0
3
+ Version: 2.0.0
4
4
  Summary: Headless Python engine for isolated network namespace testing and PCAP assertions.
5
5
  Author: onyks
6
6
  License: MIT
@@ -8,7 +8,7 @@ Project-URL: Homepage, https://github.com/onyks-os/NetworkSandboxEngine
8
8
  Project-URL: Repository, https://github.com/onyks-os/NetworkSandboxEngine
9
9
  Project-URL: Issues, https://github.com/onyks-os/NetworkSandboxEngine/issues
10
10
  Keywords: networking,namespace,testing,nftables,pcap,scapy
11
- Classifier: Development Status :: 5 - Production/Stable
11
+ Classifier: Development Status :: 4 - Beta
12
12
  Classifier: Intended Audience :: Developers
13
13
  Classifier: License :: OSI Approved :: MIT License
14
14
  Classifier: Operating System :: POSIX :: Linux
@@ -22,18 +22,22 @@ Requires-Python: >=3.10
22
22
  Description-Content-Type: text/markdown
23
23
  License-File: LICENSE
24
24
  Requires-Dist: scapy>=2.5.0
25
+ Requires-Dist: pydantic>=2.0.0
25
26
  Provides-Extra: cli
26
- Requires-Dist: pydantic>=2.0.0; extra == "cli"
27
27
  Requires-Dist: pyyaml>=6.0; extra == "cli"
28
28
  Provides-Extra: gui
29
29
  Requires-Dist: fastapi>=0.111.0; extra == "gui"
30
30
  Requires-Dist: uvicorn[standard]>=0.29.0; extra == "gui"
31
31
  Requires-Dist: websockets>=12.0; extra == "gui"
32
- Requires-Dist: pydantic>=2.0.0; extra == "gui"
33
32
  Provides-Extra: dev
34
33
  Requires-Dist: pytest>=8.0.0; extra == "dev"
35
34
  Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
36
35
  Requires-Dist: ruff; extra == "dev"
36
+ Requires-Dist: import-linter; extra == "dev"
37
+ Requires-Dist: mypy; extra == "dev"
38
+ Requires-Dist: mkdocs>=1.5.0; extra == "dev"
39
+ Requires-Dist: mkdocs-material>=9.5.0; extra == "dev"
40
+ Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "dev"
37
41
  Dynamic: license-file
38
42
 
39
43
  # Network Sandbox Engine (NSE)
@@ -156,8 +160,7 @@ nse-runner --file my_tests.yaml
156
160
  git clone https://github.com/onyks-os/NetworkSandboxEngine.git
157
161
  cd NetworkSandboxEngine
158
162
  make setup # bootstrap venv + npm install
159
- make run-rootd # starts root socket daemon (requires sudo -E)
160
- make run-web # starts FastAPI web server (runs as normal user)
163
+ make run-web # starts FastAPI web server (requires root for netns)
161
164
  make frontend # starts Vite dev server on port 5173
162
165
  ```
163
166
 
@@ -190,7 +193,7 @@ NetworkSandboxEngine/
190
193
  | `-- gui_svelte/ # Svelte + Vite frontend
191
194
  |
192
195
  |-- tests/
193
- | `-- test_netns.py # 20 unit tests (2 skipped without root)
196
+ | `-- test_netns.py # 20 unit tests (2 root integration tests)
194
197
  |
195
198
  |-- pyproject.toml # Build config - packages only nse/
196
199
  |-- Makefile # make setup | test | lint | release
@@ -275,8 +278,8 @@ Output in `release/`:
275
278
 
276
279
  ```
277
280
  release/
278
- |-- network_sandbox_engine-1.1.0-py3-none-any.whl
279
- |-- network_sandbox_engine-1.1.0.tar.gz
281
+ |-- network_sandbox_engine-1.1.1-py3-none-any.whl
282
+ |-- network_sandbox_engine-1.1.1.tar.gz
280
283
  |-- Dockerfile
281
284
  |-- nse.service
282
285
  |-- SHA256SUMS
@@ -286,7 +289,7 @@ release/
286
289
  ### Native Installation with Systemd
287
290
 
288
291
  ```bash
289
- sudo pip install release/network_sandbox_engine-1.1.0-py3-none-any.whl
292
+ sudo pip install release/network_sandbox_engine-1.1.1-py3-none-any.whl
290
293
  sudo cp release/nse.service /etc/systemd/system/
291
294
  sudo systemctl daemon-reload && sudo systemctl enable --now nse
292
295
  ```
@@ -11,14 +11,18 @@ nse/__init__.py
11
11
  nse/cli/__init__.py
12
12
  nse/cli/runner.py
13
13
  nse/core/__init__.py
14
+ nse/core/mock_listener.py
15
+ nse/core/naming.py
14
16
  nse/core/netns_controller.py
15
17
  nse/core/pipeline.py
16
18
  nse/core/rule_engine.py
17
19
  nse/core/scapy_injector.py
18
20
  nse/core/sniffer.py
21
+ nse/core/trace_harvester.py
19
22
  nse/core/utils.py
20
23
  nse/models/__init__.py
21
- nse/models/base.py
22
24
  nse/models/test_request.py
23
25
  nse/models/trace_event.py
24
- tests/test_netns.py
26
+ tests/test_netns.py
27
+ tests/test_oracle_e2e.py
28
+ tests/test_trace_parser.py
@@ -1,16 +1,20 @@
1
1
  scapy>=2.5.0
2
+ pydantic>=2.0.0
2
3
 
3
4
  [cli]
4
- pydantic>=2.0.0
5
5
  pyyaml>=6.0
6
6
 
7
7
  [dev]
8
8
  pytest>=8.0.0
9
9
  pytest-asyncio>=0.23.0
10
10
  ruff
11
+ import-linter
12
+ mypy
13
+ mkdocs>=1.5.0
14
+ mkdocs-material>=9.5.0
15
+ mkdocstrings[python]>=0.24.0
11
16
 
12
17
  [gui]
13
18
  fastapi>=0.111.0
14
19
  uvicorn[standard]>=0.29.0
15
20
  websockets>=12.0
16
- pydantic>=2.0.0
@@ -4,4 +4,6 @@
4
4
  from .core.netns_controller import NetnsController
5
5
  from .core.sniffer import PCAPAsserter
6
6
 
7
- __all__ = ["NetnsController", "PCAPAsserter"]
7
+ __version__ = "2.0.0"
8
+
9
+ __all__ = ["NetnsController", "PCAPAsserter", "__version__"]
@@ -1,33 +1,25 @@
1
1
  # Copyright (c) 2026 onyks
2
2
  # Licensed under the MIT License.
3
3
 
4
- import sys
5
4
  import argparse
6
- import time
7
5
  import asyncio
6
+ import sys
8
7
 
9
8
  try:
10
9
  import yaml
11
- from pydantic import ValidationError
12
- from nse.models.test_request import TestRequest, PacketSpec, TopologyType
13
- from nse.models.trace_event import TraceEvent
14
- from nse.core.netns_controller import NetnsController, TestRun
15
- from nse.core.pipeline import run_test_pipeline
16
10
  except ImportError:
17
11
  yaml = None
18
- ValidationError = None
19
- TestRequest = None
20
- PacketSpec = None
21
- TopologyType = None
22
- TraceEvent = None
23
- NetnsController = None
24
- TestRun = None
25
- run_test_pipeline = None
12
+
13
+ from pydantic import ValidationError
14
+
15
+ from nse.core.netns_controller import NetnsController
16
+ from nse.core.pipeline import run_test_pipeline
17
+ from nse.models.test_request import PacketSpec, TestRequest, TopologyType
26
18
 
27
19
 
28
20
  def check_cli_dependencies() -> None:
29
21
  """Verify that CLI extras are installed."""
30
- if yaml is None or ValidationError is None or TestRequest is None:
22
+ if yaml is None:
31
23
  print("[FATAL ERROR] Missing dependencies for CLI runner.", file=sys.stderr)
32
24
  print("To use the YAML test runner, install the CLI extras:", file=sys.stderr)
33
25
  print(" pip install 'network-sandbox-engine[cli]'", file=sys.stderr)
@@ -56,14 +48,14 @@ def main() -> None:
56
48
 
57
49
  print(f"[NSE] Loading test suite from: {args.file}")
58
50
  try:
59
- with open(args.file, "r") as f:
51
+ with open(args.file) as f:
60
52
  if args.file.endswith(".json"):
61
53
  import json
62
54
 
63
55
  data = json.load(f)
64
56
  else:
65
57
  data = yaml.safe_load(f)
66
- except Exception as e:
58
+ except (yaml.YAMLError, OSError, ValueError) as e:
67
59
  print(f"Error reading test suite file: {e}", file=sys.stderr)
68
60
  sys.exit(1)
69
61
 
@@ -124,41 +116,33 @@ def main() -> None:
124
116
  failed += 1
125
117
  continue
126
118
 
127
- test_id = f"cli_{tc_idx}_{int(time.time())}"
128
- run = TestRun(test_id=test_id, netns_name=f"nse_{test_id}", request=request)
129
-
130
119
  try:
131
- loop.run_until_complete(run_test_pipeline(controller, run))
132
- except Exception as e:
120
+ events = loop.run_until_complete(
121
+ run_test_pipeline(request=request, controller=controller)
122
+ )
123
+ except (RuntimeError, OSError, ValueError) as e:
133
124
  print(f" [FAIL] Pipeline crashed with error: {e}")
134
125
  failed += 1
135
126
  continue
136
127
 
137
- events = []
138
- while not run.event_queue.empty():
139
- evt = loop.run_until_complete(run.event_queue.get())
140
- if evt is None:
141
- continue
142
- events.append(evt)
143
-
144
- trace_id_to_verdicts = {}
145
- trace_id_to_hook = {}
146
- all_seen_trace_ids = []
147
- errors = []
128
+ trace_id_to_verdicts: dict[str, list[str]] = {}
129
+ trace_id_to_user_table: dict[str, bool] = {}
130
+ all_seen_trace_ids: list[str] = []
131
+ errors: list[str] = []
148
132
 
149
133
  for evt in events:
150
134
  if evt.type == "error":
151
- errors.append(evt.raw_message)
135
+ if evt.raw_message:
136
+ errors.append(evt.raw_message)
152
137
  elif evt.trace_id:
153
138
  if evt.trace_id not in trace_id_to_verdicts:
154
139
  trace_id_to_verdicts[evt.trace_id] = []
155
140
  all_seen_trace_ids.append(evt.trace_id)
156
141
 
157
- if evt.type == "hook" and evt.hook:
158
- if evt.trace_id not in trace_id_to_hook:
159
- trace_id_to_hook[evt.trace_id] = evt.hook
142
+ if evt.table and evt.table != "nse_trace":
143
+ trace_id_to_user_table[evt.trace_id] = True
160
144
 
161
- if evt.verdict:
145
+ if evt.verdict and evt.table != "nse_trace":
162
146
  trace_id_to_verdicts[evt.trace_id].append(evt.verdict.upper())
163
147
 
164
148
  if errors:
@@ -166,20 +150,8 @@ def main() -> None:
166
150
  failed += 1
167
151
  continue
168
152
 
169
- # Keep only trace IDs that enter on the expected injection hook interface
170
- ordered_trace_ids = []
171
- for tid in all_seen_trace_ids:
172
- hook = trace_id_to_hook.get(tid, "")
173
- is_valid = False
174
- if topology == TopologyType.GATEWAY:
175
- if hook.startswith("vrh-") or hook == "veth-nse":
176
- is_valid = True
177
- else:
178
- if hook == "veth-nse":
179
- is_valid = True
180
-
181
- if is_valid:
182
- ordered_trace_ids.append(tid)
153
+ # Keep only trace IDs that traversed user-defined rulesets (excluding nse_trace setup noise)
154
+ ordered_trace_ids = [tid for tid in all_seen_trace_ids if trace_id_to_user_table.get(tid)]
183
155
 
184
156
  actual_verdicts = []
185
157
  for tid in ordered_trace_ids:
@@ -188,14 +160,15 @@ def main() -> None:
188
160
  actual_verdicts.append("DROP")
189
161
  elif any(v == "ACCEPT" for v in v_list):
190
162
  actual_verdicts.append("ACCEPT")
191
- else:
192
- actual_verdicts.append("DROP")
193
163
 
194
- while len(actual_verdicts) < len(expected_verdicts):
195
- actual_verdicts.append("DROP")
164
+ if len(actual_verdicts) != len(expected_verdicts):
165
+ print(
166
+ f" [FAIL] Oracle Error: Expected {len(expected_verdicts)} verdicts, "
167
+ f"but observed {len(actual_verdicts)}."
168
+ )
196
169
 
197
170
  test_passed = True
198
- for idx, (exp, act) in enumerate(zip(expected_verdicts, actual_verdicts)):
171
+ for idx, (exp, act) in enumerate(zip(expected_verdicts, actual_verdicts, strict=False)):
199
172
  if exp != act:
200
173
  print(f" [FAIL] Packet {idx + 1}: expected {exp}, got {act}")
201
174
  test_passed = False
@@ -0,0 +1,132 @@
1
+ # Copyright (c) 2026 onyks
2
+ # Licensed under the MIT License.
3
+
4
+ """
5
+ Mock Listeners for TCP/UDP servers inside namespaces.
6
+ Can be run as a standalone script or imported to manage Popen processes.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ import argparse
12
+ import logging
13
+ import socket
14
+ import subprocess
15
+ import sys
16
+ import threading
17
+ import time
18
+
19
+ logger = logging.getLogger("nse.core.mock_listener")
20
+
21
+
22
+ def run_tcp_server(host: str, port: int) -> None:
23
+ family = socket.AF_INET6 if ":" in host else socket.AF_INET
24
+ s = socket.socket(family, socket.SOCK_STREAM)
25
+ s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
26
+ try:
27
+ s.bind((host, port))
28
+ s.listen(5)
29
+ print(f"TCP server listening on {host}:{port}", flush=True)
30
+ except OSError as e:
31
+ print(f"Error binding TCP to {host}:{port}: {e}", file=sys.stderr, flush=True)
32
+ sys.exit(1)
33
+
34
+ while True:
35
+ try:
36
+ conn, _ = s.accept()
37
+
38
+ # Handle client in a daemon thread
39
+ def handle_client(c: socket.socket) -> None:
40
+ try:
41
+ c.settimeout(5.0)
42
+ while True:
43
+ data = c.recv(1024)
44
+ if not data:
45
+ break
46
+ c.sendall(data)
47
+ except OSError:
48
+ pass
49
+ finally:
50
+ c.close()
51
+
52
+ t = threading.Thread(target=handle_client, args=(conn,), daemon=True)
53
+ t.start()
54
+ except KeyboardInterrupt:
55
+ break
56
+ except OSError:
57
+ time.sleep(0.1)
58
+
59
+
60
+ def run_udp_server(host: str, port: int) -> None:
61
+ family = socket.AF_INET6 if ":" in host else socket.AF_INET
62
+ s = socket.socket(family, socket.SOCK_DGRAM)
63
+ try:
64
+ s.bind((host, port))
65
+ print(f"UDP server listening on {host}:{port}", flush=True)
66
+ except OSError as e:
67
+ print(f"Error binding UDP to {host}:{port}: {e}", file=sys.stderr, flush=True)
68
+ sys.exit(1)
69
+
70
+ while True:
71
+ try:
72
+ data, addr = s.recvfrom(2048)
73
+ s.sendto(data, addr)
74
+ except KeyboardInterrupt:
75
+ break
76
+ except OSError:
77
+ time.sleep(0.1)
78
+
79
+
80
+ def start_mock_listener(
81
+ netns_name: str,
82
+ proto: str,
83
+ port: int,
84
+ host: str = "::",
85
+ use_nsenter: bool = False,
86
+ ) -> subprocess.Popen[str]:
87
+ """Spawns a mock listener inside the namespace in a background process."""
88
+ cmd = []
89
+ if use_nsenter:
90
+ cmd += ["nsenter", f"--net=/var/run/netns/{netns_name}", "--"]
91
+ else:
92
+ cmd += ["ip", "netns", "exec", netns_name]
93
+ cmd += [
94
+ sys.executable,
95
+ "-u",
96
+ "-m",
97
+ "nse.core.mock_listener",
98
+ "--proto",
99
+ proto.lower(),
100
+ "--port",
101
+ str(port),
102
+ "--host",
103
+ host,
104
+ ]
105
+ logger.info("Spawning listener inside %s: %s", netns_name, " ".join(cmd))
106
+ proc = subprocess.Popen(
107
+ cmd,
108
+ stdout=subprocess.PIPE,
109
+ stderr=subprocess.PIPE,
110
+ text=True,
111
+ )
112
+ # Give a tiny slice for the listener to bind and print the starting message
113
+ time.sleep(0.15)
114
+ return proc
115
+
116
+
117
+ if __name__ == "__main__":
118
+ parser = argparse.ArgumentParser(description="NSE Mock Listener Daemon")
119
+ parser.add_argument("--proto", choices=["tcp", "udp"], default="tcp")
120
+ parser.add_argument("--port", type=int, required=True)
121
+ parser.add_argument("--host", default="::")
122
+ args = parser.parse_args()
123
+
124
+ # If dual-stack isn't enabled or is blocked, let's fallback to IPv4 if host is "::" and bind fails,
125
+ # but since Linux typically supports IPv6 bind for dual-stack or explicitly IPv6, let's keep it direct.
126
+ try:
127
+ if args.proto == "tcp":
128
+ run_tcp_server(args.host, args.port)
129
+ else:
130
+ run_udp_server(args.host, args.port)
131
+ except KeyboardInterrupt:
132
+ sys.exit(0)
@@ -0,0 +1,42 @@
1
+ # Copyright (c) 2026 onyks
2
+ # Licensed under the MIT License.
3
+
4
+ """
5
+ Centralised naming conventions for network namespaces and veth pairs.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ from dataclasses import dataclass
11
+
12
+
13
+ @dataclass(frozen=True)
14
+ class NamespaceNames:
15
+ test_id: str
16
+ netns: str
17
+ router_ns: str
18
+ server_ns: str
19
+ veth_host: str
20
+ veth_router_host: str
21
+ veth_router_server: str
22
+ veth_server: str
23
+
24
+
25
+ def derive_names(test_id: str) -> NamespaceNames:
26
+ """Derive deterministic namespace and veth interface names from test_id."""
27
+ suffix = test_id[:8]
28
+ return NamespaceNames(
29
+ test_id=test_id,
30
+ netns=f"nse_{test_id}",
31
+ router_ns=f"nsr_{test_id}",
32
+ server_ns=f"nss_{test_id}",
33
+ veth_host=f"vhr-{suffix}",
34
+ veth_router_host=f"vrh-{suffix}",
35
+ veth_router_server=f"vrs-{suffix}",
36
+ veth_server=f"vsr-{suffix}",
37
+ )
38
+
39
+
40
+ # Prefixes used by the startup cleanup sweep
41
+ NETNS_SWEEP_PREFIXES = ("nse_", "nsr_", "nss_")
42
+ VETH_SWEEP_PREFIXES = ("vhr-", "vrh-", "vrs-", "vsr-")