test: support non-root checkout paths

Signed-off-by: svcnemo-autobot <svcnemo-autobot@nvidia.com>

Author: svcnemo-autobot

CONTRIBUTING.md

@@ -21,6 +21,29 @@ On a machine with CUDA, you can additionally sync vLLM:
 uv sync --extra te --extra vllm
 ```
 
+### CI container
+
+To reproduce CI without modifying the prebuilt image, mount a checkout at any
+writable location and run with your host user. Replace `$IMAGE` with the image
+built by the `cicd-container-build` job and `$COMMIT` with the revision under
+test:
+
+```bash
+git worktree add --detach export-deploy-test "$COMMIT"
+docker run --rm -it \
+    --user "$(id -u):$(id -g)" \
+    --env HOME=/tmp/export-deploy-home \
+    --env PATH=/opt/venv/bin:/usr/local/bin:/usr/bin:/bin \
+    --workdir /workdir \
+    --volume "$(pwd)/export-deploy-test:/workdir" \
+    "$IMAGE" \
+    bash tests/unit_tests/L0_Unit_Tests_CPU.sh
+```
+
+GPU and functional scripts can be invoked from the same checkout after adding
+the runtime's GPU flags and test-data mount. The scripts write coverage data to
+the checkout root rather than requiring `/workspace` or root privileges.
+
 ## 📦 Dependencies management
 
 We use [uv](https://docs.astral.sh/uv/) for managing dependencies. For reproducible builds, our project tracks the generated `uv.lock` file in the repository.  

tests/coverage.py

@@ -0,0 +1,29 @@
+# Copyright (c) 2026, NVIDIA CORPORATION.  All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).resolve().parent.parent
+COVERAGE_DATA_FILE = PROJECT_ROOT / ".coverage"
+
+
+def coverage_args() -> list[str]:
+    """Return coverage arguments rooted at the active checkout."""
+    return [
+        "coverage",
+        "run",
+        f"--data-file={COVERAGE_DATA_FILE}",
+        f"--source={PROJECT_ROOT}",
+        "--parallel-mode",
+    ]

tests/functional_tests/L2_Launch_InFramework.sh

@@ -16,10 +16,11 @@
 set -xeuo pipefail # Exit immediately if a command exits with a non-zero status
 
 export CUDA_VISIBLE_DEVICES="0,1"
+PROJECT_ROOT=$(git rev-parse --show-toplevel)
 
 coverage run \
-    --data-file=/workspace/.coverage \
-    --source=/workspace/ \
+    --data-file="$PROJECT_ROOT/.coverage" \
+    --source="$PROJECT_ROOT" \
     --parallel-mode \
     -m pytest \
     -o log_cli=true \

tests/functional_tests/L2_Launch_vLLM.sh

@@ -16,10 +16,11 @@
 set -xeuo pipefail # Exit immediately if a command exits with a non-zero status
 
 export CUDA_VISIBLE_DEVICES="0"
+PROJECT_ROOT=$(git rev-parse --show-toplevel)
 
 coverage run \
-    --data-file=/workspace/.coverage \
-    --source=/workspace/ \
+    --data-file="$PROJECT_ROOT/.coverage" \
+    --source="$PROJECT_ROOT" \
     --parallel-mode \
     -m pytest \
     -o log_cli=true \

tests/functional_tests/L2_ONNX_TRT.sh

@@ -19,10 +19,11 @@ set -xeuo pipefail # Exit immediately if a command exits with a non-zero status
 pushd .. && uv pip install transformers==4.51.3 && popd
 
 export CUDA_VISIBLE_DEVICES="0,1"
+PROJECT_ROOT=$(git rev-parse --show-toplevel)
 
 coverage run \
-    --data-file=/workspace/.coverage \
-    --source=/workspace/ \
+    --data-file="$PROJECT_ROOT/.coverage" \
+    --source="$PROJECT_ROOT" \
     --parallel-mode \
     -m pytest \
     -o log_cli=true \

tests/functional_tests/tests_inframework/test_deploy_query_hf_ray.py

@@ -16,6 +16,8 @@
 import subprocess
 import time
 
+from tests.coverage import coverage_args
+
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
@@ -45,11 +47,7 @@ def test_deploy_ray_hf(self):
             # Run Ray deployment for HF model
             self.deploy_proc = subprocess.Popen(
                 [
-                    "coverage",
-                    "run",
-                    "--data-file=/workspace/.coverage",
-                    "--source=/workspace/",
-                    "--parallel-mode",
+                    *coverage_args(),
                     "scripts/deploy/nlp/deploy_ray_hf.py",
                     "--model_path",
                     hf_model_path,

tests/functional_tests/tests_inframework/test_deploy_query_mbridge_ray.py

@@ -16,6 +16,8 @@
 import subprocess
 import time
 
+from tests.coverage import coverage_args
+
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
@@ -48,11 +50,7 @@ def test_deploy_ray(self):
             # Run Ray deployment
             self.deploy_proc = subprocess.Popen(
                 [
-                    "coverage",
-                    "run",
-                    "--data-file=/workspace/.coverage",
-                    "--source=/workspace/",
-                    "--parallel-mode",
+                    *coverage_args(),
                     "scripts/deploy/nlp/deploy_ray_inframework.py",
                     "--megatron_checkpoint",
                     mbridge_checkpoint_path,

tests/functional_tests/tests_inframework/test_deploy_query_vlm_ray.py

@@ -18,6 +18,8 @@
 
 import requests
 
+from tests.coverage import coverage_args
+
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
@@ -72,11 +74,7 @@ def test_deploy_ray(self):
             # Run Ray deployment for Megatron multimodal (VLM) model
             self.deploy_proc = subprocess.Popen(
                 [
-                    "coverage",
-                    "run",
-                    "--data-file=/workspace/.coverage",
-                    "--source=/workspace/",
-                    "--parallel-mode",
+                    *coverage_args(),
                     "scripts/deploy/multimodal/deploy_ray_inframework.py",
                     "--megatron_checkpoint",
                     vlm_checkpoint_path,

tests/functional_tests/tests_onnx_trt/test_export.py

@@ -20,6 +20,8 @@
 
 import pytest
 
+from tests.coverage import coverage_args
+
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
@@ -38,11 +40,7 @@ class TestONNXTRTExport:
     def test_export_onnx_trt_embedding(self):
         subprocess.run(
             [
-                "coverage",
-                "run",
-                "--data-file=/workspace/.coverage",
-                "--source=/workspace/",
-                "--parallel-mode",
+                *coverage_args(),
                 "tests/functional_tests/utils/run_onnx_trt_embedding_export.py",
                 "--hf_model_path",
                 "/home/TestData/llm/models/llama-3.2-nv-embedqa-1b-v2",
@@ -58,11 +56,7 @@ def test_export_onnx_trt_embedding(self):
     def test_export_onnx_trt_embedding_int8(self):
         subprocess.run(
             [
-                "coverage",
-                "run",
-                "--data-file=/workspace/.coverage",
-                "--source=/workspace/",
-                "--parallel-mode",
+                *coverage_args(),
                 "tests/functional_tests/utils/run_onnx_trt_embedding_export.py",
                 "--hf_model_path",
                 "/home/TestData/llm/models/llama-3.2-nv-embedqa-1b-v2",
@@ -85,11 +79,7 @@ def test_export_onnx_trt_embedding_int8(self):
     def test_export_onnx_trt_reranking(self):
         subprocess.run(
             [
-                "coverage",
-                "run",
-                "--data-file=/workspace/.coverage",
-                "--source=/workspace/",
-                "--parallel-mode",
+                *coverage_args(),
                 "tests/functional_tests/utils/run_onnx_trt_reranking_export.py",
                 "--hf_model_path",
                 "/home/TestData/llm/models/llama-3.2-nv-reranker-1b",

tests/functional_tests/tests_vllm/test_deploy_query_hf_ray_vllm.py

@@ -16,6 +16,8 @@
 import subprocess
 import time
 
+from tests.coverage import coverage_args
+
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
@@ -46,11 +48,7 @@ def test_deploy_ray_hf_vllm_backend(self):
             # Run Ray deployment for HF model with vLLM backend
             self.deploy_proc = subprocess.Popen(
                 [
-                    "coverage",
-                    "run",
-                    "--data-file=/workspace/.coverage",
-                    "--source=/workspace/",
-                    "--parallel-mode",
+                    *coverage_args(),
                     "scripts/deploy/nlp/deploy_ray_hf.py",
                     "--model_path",
                     hf_model_path,
@@ -134,11 +132,7 @@ def test_deploy_ray_hf_vllm_backend_with_parameters(self):
             # Run Ray deployment for HF model with vLLM backend and custom parameters
             self.deploy_proc = subprocess.Popen(
                 [
-                    "coverage",
-                    "run",
-                    "--data-file=/workspace/.coverage",
-                    "--source=/workspace/",
-                    "--parallel-mode",
+                    *coverage_args(),
                     "scripts/deploy/nlp/deploy_ray_hf.py",
                     "--model_path",
                     hf_model_path,