rosotacom-dev 2.5.dev4__py3-none-any.whl → 2.5.dev6__py3-none-any.whl

rosotacom/cli.py

@@ -4249,13 +4249,40 @@ def _create_scenario_tmux(
     return session_name
 
 
+def _local_ipc_run_args(network_isolated: bool) -> list[str]:
+    """Share the host IPC namespace, unless the run is network-isolated.
+
+    A peer has to exchange local-domain data with application containers on the
+    same machine — a replay, the control centre. With `--network host` but
+    `ipc=private` each container has its own `/dev/shm`, FastDDS sees two
+    participants on one host, negotiates shared memory, and writes into a
+    segment the other side cannot map. Discovery goes over UDP and works;
+    delivery goes over SHM and is dropped without a word.
+
+    The result is the worst shape a failure can take: the link comes up, the
+    heartbeat crosses at 10 Hz with 0% loss, every pipeline reads `pub=1 sub=1`
+    — and no payload ever enters it. Measured on 2026-08-09: 399 messages in
+    eight seconds inside the publisher's container, 0 in the peer's.
+
+    The OTA path never showed it, because the generated unicast profile pins
+    explicit locators and therefore forces UDP.
+
+    Not under `--network-name`. Sharing SHM there would let DDS bypass the very
+    boundary the isolation exists to simulate, and a test that passes through a
+    hole in its own isolation is worse than no test at all.
+    """
+    return [] if network_isolated else ["--ipc", "host"]
+
+
 def _base_extra_run_args(
     runtime: RuntimeConfig,
     session: ResolvedSession,
     cfg: dict[str, Any],
     instance: SessionInstance,
+    *,
+    network_isolated: bool = False,
 ) -> list[str]:
-    args: list[str] = []
+    args: list[str] = _local_ipc_run_args(network_isolated)
     ros2docker_cfg = load_config(runtime.ros2docker_config)
 
     if not ros2docker_cfg.get("mount_ws"):
@@ -4425,7 +4452,7 @@ def start_session(args: argparse.Namespace) -> str:
                 " (or pass --force to replace it, --skip-conflict-check to ignore it).",
             )
     image_name = _scoped_image_name(runtime)
-    extra_run_args = _base_extra_run_args(runtime, session, cfg, instance)
+    extra_run_args = _base_extra_run_args(runtime, session, cfg, instance, network_isolated=network_isolated)
     run_override: dict[str, object] = {}
     network_name = getattr(args, "network_name", None)
     if network_name:
@@ -6513,6 +6540,26 @@ def test_command(args: argparse.Namespace) -> int:
         from . import bag_ground_truth
 
         ground_truth = bag_ground_truth.bag_ground_truth(bag)
+    elif not getattr(args, "suggest", False):
+        # A `vs_bag_ratio` needs the bag's native rate, and without one it is
+        # skipped rather than failed -- so the run would print TEST OK having
+        # checked nothing about completeness. Refuse instead: the declaration
+        # is the statement of intent, and honouring it or failing loudly is
+        # this command's job.
+        needs_bag = status_eval.topics_requiring_bag(expect_by_topic, profile)
+        if needs_bag:
+            listed = "\n".join(f"    {base}" for base in needs_bag)
+            print(
+                f"rosotacom test: {len(needs_bag)} topic(s) declare "
+                f"`completeness.vs_bag_ratio`, which compares the delivered rate "
+                f"to the source's native rate and can only be evaluated against "
+                f"the replay bag:\n{listed}\n"
+                f"Pass `--bag <dir>`, or drop the assertion from a session that "
+                f"is not replay-driven. Without a bag it would be skipped in "
+                f"silence and this run would report success.",
+                file=sys.stderr,
+            )
+            return 1
     reports: dict[str, Any] = {}
     failures: list[str] = []
 

rosotacom/status_eval.py

@@ -105,6 +105,27 @@ def resolve_expect_for_profile(expect: dict[str, Any], profile: str | None) -> d
     return resolved
 
 
+def topics_requiring_bag(expect_by_topic: dict[str, dict[str, Any]], profile: str | None = None) -> list[str]:
+    """Topics whose expectations can only be evaluated against a replay bag.
+
+    `completeness.vs_bag_ratio` compares the delivered rate to the *source's*
+    native rate, which only a bag knows. `_check_bag_completeness` returns
+    early when no ground truth was supplied, so without `--bag` such an
+    expectation is skipped in silence and the run still prints `TEST OK`.
+
+    A skipped assertion reads as coverage, which is worse than no assertion at
+    all: it is the exact shape of the defect these contracts exist to catch.
+    The caller uses this to refuse the run instead.
+    """
+    required = []
+    for base, raw in sorted((expect_by_topic or {}).items()):
+        expect = resolve_expect_for_profile(raw or {}, profile)
+        completeness = expect.get("completeness") or {}
+        if isinstance(completeness, dict) and completeness.get("vs_bag_ratio") is not None:
+            required.append(base)
+    return required
+
+
 def expectations_from_cfg(cfg: dict[str, Any]) -> dict[str, dict[str, Any]]:
     """Map a topic's base name -> its `expect` block, from a session config."""
     out: dict[str, dict[str, Any]] = {}

{rosotacom_dev-2.5.dev4.dist-info → rosotacom_dev-2.5.dev6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rosotacom-dev
-Version: 2.5.dev4
+Version: 2.5.dev6
 Summary: Host CLI for ROS OTA communication sessions.
 Author: develNor
 License-Expression: BSD-3-Clause

{rosotacom_dev-2.5.dev4.dist-info → rosotacom_dev-2.5.dev6.dist-info}/RECORD

@@ -5,7 +5,7 @@ rosotacom/bag_ground_truth.py,sha256=FlL34fA2CWZZxsrz7uxfhPt2VntPuS0ldrOPy58XPMk
 rosotacom/benched_set.py,sha256=PGybWzNKJhg5wouIGo_zxlb7Fu41UzmtgEBxUR-Gkvg,19874
 rosotacom/benchmark.py,sha256=Xda8WwFKQEIRMO0Qe1Hf7rvykYIgM86gUHBuyX9VvI8,74447
 rosotacom/bundle_check.py,sha256=l_3BSuYk6juXQmsNU6jkxRbH8ayH2GkiW9ONKMQ1oJY,18270
-rosotacom/cli.py,sha256=CbSemM55JZMI_oJQ683q73xzcF2DQ-b0DOmZINO69fM,360499
+rosotacom/cli.py,sha256=5nztYmxzS0rwY1RIFCzvLYcMAN4X-DqcdzMHp-obH-I,363053
 rosotacom/cli_benchmark.py,sha256=bhdtvvO73g3-vlWTX0hf7I70lKQVT0pyXbIg3YnXfLQ,342197
 rosotacom/deployment.py,sha256=XVhB8JjxhAsglSEEPtiVSeV6fCG0rgGmDRulh14oIYQ,7318
 rosotacom/ffmpeg_packet.py,sha256=zB1BHgY1kexr5sETVMkm4bkVnRytj9k2t0uOYiHUZ6M,4267
@@ -15,7 +15,7 @@ rosotacom/network_profiles.py,sha256=fCsZYoSKBjAAYkC7Gbyv4s5L9OVmZs_hAHWTf0xMfHU
 rosotacom/network_shaper.py,sha256=kjn9ZtiO1SMm8UHKIjmn92JBu_hE5TJF6vaNF1XKtNU,5463
 rosotacom/plots.py,sha256=YRGRxuGHSHDZmtL0sv1JS7cPVSL9VzjGYuvMxeHAj54,22674
 rosotacom/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rosotacom/status_eval.py,sha256=ypnxMV0u-NfNZuf59izPwUmO6gYISkJ1z1TK33vEbcE,22062
+rosotacom/status_eval.py,sha256=V9KVho5DEBYCD_iG1X2Yg6qd6ZEzopdKSY5QJ6K1sP4,23115
 rosotacom/stream_stats.py,sha256=ey09g4B7y0E-NnsOBW8Ng9kqyMbo2xuabNut9op6uM4,23744
 rosotacom/trace_profiles.py,sha256=KNM1RExHDXkppWZdqbSPXTjwJ8f7io8IU48HnKzmHKY,20567
 rosotacom/transit.py,sha256=0BqDO3nfYJ1PMXRz8b3084sDOrCjhO5zwdqC_-qU6bo,10531
@@ -187,9 +187,9 @@ rosotacom/resources/ws/session/creation/generate_session_files.py,sha256=R4HFetZ
 rosotacom/resources/ws/session/creation/run_session.py,sha256=G2hJhrmLp11gm3JZ6_C-zZcqu_reXlE_wmobB7BiCfU,16849
 rosotacom/resources/ws/session/creation/run_session_in_external_terminal.py,sha256=Ub_5f-ttUUc-rAPrZmg_Op34s8Z4C91hTyEn8fgyt-E,2633
 rosotacom/resources/ws/session/creation/strip_ansi.py,sha256=vNjpemcq4xHr0VG4x0bZqvgwEBEfOgN-b4PzbrM5nfM,851
-rosotacom_dev-2.5.dev4.dist-info/licenses/LICENSE.txt,sha256=FDB3-fao3lqZ94wsJHKAH7U88kAnfvZhZC8Hm5rN__g,1459
-rosotacom_dev-2.5.dev4.dist-info/METADATA,sha256=Fejzd9GZmMZbpVsJMqTPnkGJHwvyma8wLchRoMT0xBA,46417
-rosotacom_dev-2.5.dev4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-rosotacom_dev-2.5.dev4.dist-info/entry_points.txt,sha256=-Hl9WKAfkLjMHUonDTxvz86EgSfZf6oyatRMxypS5iA,147
-rosotacom_dev-2.5.dev4.dist-info/top_level.txt,sha256=BZrtQcIVDWn_pQZR3Mlssqy5SaRXHjOa6B-1D9Fy4Ao,10
-rosotacom_dev-2.5.dev4.dist-info/RECORD,,
+rosotacom_dev-2.5.dev6.dist-info/licenses/LICENSE.txt,sha256=FDB3-fao3lqZ94wsJHKAH7U88kAnfvZhZC8Hm5rN__g,1459
+rosotacom_dev-2.5.dev6.dist-info/METADATA,sha256=ExbIFkLKV4qhOiGTz1NqBTBKAmk8TctpZ81GsPR2dMU,46417
+rosotacom_dev-2.5.dev6.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+rosotacom_dev-2.5.dev6.dist-info/entry_points.txt,sha256=-Hl9WKAfkLjMHUonDTxvz86EgSfZf6oyatRMxypS5iA,147
+rosotacom_dev-2.5.dev6.dist-info/top_level.txt,sha256=BZrtQcIVDWn_pQZR3Mlssqy5SaRXHjOa6B-1D9Fy4Ao,10
+rosotacom_dev-2.5.dev6.dist-info/RECORD,,