Moving the mock_qpu utils under python

.github/pre-commit/spellcheck_config.yml

@@ -264,7 +264,7 @@ matrix:
   sources:
   # Exclude test directories, third-party code (tpls/), build artifacts, sphinx config,
   # and files with f-string syntax that pyspelling's parser can't handle
-  - '**/*.py|!python/tests/**/*.py|!cudaq/test/**/*.py|!targettests/**/*.py|!tpls/**/*.py|!_skbuild/**/*.py|!build/**/*.py|!build_*/**/*.py|!_version.py|!docs/sphinx/conf.py|!utils/mock_qpu/qci/__init__.py'
+  - '**/*.py|!python/tests/**/*.py|!cudaq/test/**/*.py|!targettests/**/*.py|!tpls/**/*.py|!_skbuild/**/*.py|!build/**/*.py|!build_*/**/*.py|!_version.py|!docs/sphinx/conf.py'
   glob_flags: N|G|B
   expect_match: false
   aspell:

.github/workflows/test_in_devenv.yml

@@ -309,26 +309,17 @@ jobs:
               echo "::error file=test_in_devenv.yml::Python tests failed with status $pytest_status."
               exit 1
             fi
-            mock_qpu_failures=""
             for backendTest in python/tests/backends/*.py; do
               output=$(python -m pytest -v -s --durations=0 $backendTest 2>&1)
               pytest_status=$?
               echo "$output"
-              if echo "$output" | grep -q "Mock qpu not available"; then
-                echo "::error file=test_in_devenv.yml::Mock QPU unavailable for $backendTest"
-                mock_qpu_failures="$mock_qpu_failures $backendTest"
-              fi
               # Exit code 5 indicates that no tests were collected,
               # i.e. all tests in this file were skipped.
               if [ ! $pytest_status -eq 0 ] && [ ! $pytest_status -eq 5 ]; then
                 echo "::error file=test_in_devenv.yml::Python $backendTest tests failed with status $pytest_status."
                 exit 1
               fi
             done
-            if [ -n "$mock_qpu_failures" ]; then
-              echo "::error file=test_in_devenv.yml::Mock QPU tests skipped due to missing startServer:$mock_qpu_failures"
-              exit 1
-            fi
 
             retry pip install qiskit
             python -m pytest -v --durations=0  python/tests/contrib

docs/sphinx/using/extending/backend.rst

@@ -301,9 +301,9 @@ Create unit tests for your server helper:
 .. code-block:: bash
 
     #!/bin/bash
-    
+
     # Start the mock server
-    python3 utils/start_mock_qpu.py <provider_name> &
+    python3 python/tests/utils/start_mock_qpu.py <provider_name> &
     SERVER_PID=$!
 
     # Wait for server to start
@@ -371,7 +371,7 @@ Create a mock server for testing:
 
 .. code-block:: text
 
-    utils/mock_qpu/<provider_name>/
+    python/tests/utils/mock_qpu/<provider_name>/
     └── __init__.py
 
 Implement the mock server:
@@ -457,11 +457,7 @@ Create Python tests for your backend:
         not (cudaq.has_target("<provider_name>")),
         reason='Could not find `<provider_name>` in installation')
 
-    try:
-        from utils.mock_qpu.<provider_name> import startServer
-    except:
-        print("Mock qpu not available, skipping Provider Name tests.")
-        pytest.skip("Mock qpu not available.", allow_module_level=True)
+    from utils.mock_qpu.<provider_name> import startServer
 
     # Define the port for the mock server - make sure this is unique
     # across all tests.

python/tests/backends/conftest.py

@@ -34,10 +34,7 @@ def quantinuum_mock_server():
     Yields the path to the credentials file.
     """
     from network_utils import check_server_connection
-    try:
-        from utils.mock_qpu.quantinuum import startServer
-    except Exception:
-        pytest.skip("Mock qpu not available.", allow_module_level=False)
+    from utils.mock_qpu.quantinuum import startServer
 
     with open(QUANTINUUM_CREDS_FILE, 'w') as f:
         f.write('key: {}\nrefresh: {}\ntime: 0'.format("nexus_key",

python/tests/backends/test_IQM.py

@@ -21,12 +21,8 @@
 
 iqm_client = pytest.importorskip("iqm.iqm_client")
 
-try:
-    from utils.mock_qpu.iqm import startServer
-    from utils.mock_qpu.iqm.mock_iqm_cortex_cli import write_a_mock_tokens_file
-except:
-    pytest.skip("Mock qpu not available, skipping IQM tests.",
-                allow_module_level=True)
+from utils.mock_qpu.iqm import startServer
+from utils.mock_qpu.iqm.mock_iqm_cortex_cli import write_a_mock_tokens_file
 
 # Define the port for the mock server
 port = 62443

python/tests/backends/test_IonQ.py

@@ -12,11 +12,7 @@
 from typing import List
 from multiprocessing import Process
 from network_utils import check_server_connection
-try:
-    from utils.mock_qpu.ionq import startServer
-except:
-    print("Mock qpu not available, skipping IonQ tests.")
-    pytest.skip("Mock qpu not available.", allow_module_level=True)
+from utils.mock_qpu.ionq import startServer
 
 # Define the port for the mock server
 port = 62441

python/tests/backends/test_OQC.py

@@ -16,11 +16,7 @@
 from cudaq import spin
 import numpy as np
 
-try:
-    from utils.mock_qpu.oqc import startServer
-except:
-    print("Mock qpu not available, skipping OQC tests.")
-    pytest.skip("Mock qpu not available.", allow_module_level=True)
+from utils.mock_qpu.oqc import startServer
 
 # Define the port for the mock server
 port = 62442

python/tests/backends/test_QCI.py

@@ -15,11 +15,7 @@
 from cudaq import spin
 from network_utils import check_server_connection
 
-try:
-    from utils.mock_qpu.qci import startServer
-except:
-    print("Mock qpu not available, skipping QCI tests.")
-    pytest.skip("Mock qpu not available.", allow_module_level=True)
+from utils.mock_qpu.qci import startServer
 
 # Define the port for the mock server
 port = 62449

python/tests/backends/test_Quantinuum_kernel.py

@@ -16,7 +16,7 @@
 
 
 def assert_close(got) -> bool:
-    return got < -1.1 and got > -2.2
+    return got < -1.1 and got > -2.21
 
 
 @pytest.fixture(scope="function", autouse=True)

python/tests/backends/test_Quantum_Machines.py

@@ -11,12 +11,7 @@
 import pytest
 from multiprocessing import Process
 from network_utils import check_server_connection
-
-try:
-    from utils.mock_qpu.quantum_machines import start_server
-except:
-    print("Mock qpu not available, skipping Quantum Machines tests.")
-    pytest.skip("Mock qpu not available.", allow_module_level=True)
+from utils.mock_qpu.quantum_machines import start_server
 
 skipIfQuantumMachinesNotInstalled = pytest.mark.skipif(
     not (cudaq.has_target("quantum_machines")),

python/tests/backends/test_qbraid.py

@@ -15,19 +15,15 @@
 from cudaq import spin
 from network_utils import check_server_connection
 
-try:
-    from utils.mock_qpu.qbraid import startServer
-except ImportError:
-    print("Mock qpu not available, skipping qBraid tests.")
-    pytest.skip("Mock qpu not available.", allow_module_level=True)
+from utils.mock_qpu.qbraid import startServer
 
 port = 62454
 
 # Default machine for tests. Mirrors the real qBraid device string format.
 TEST_MACHINE = "qbraid:qbraid:sim:qir-sv"
 TEST_API_KEY = "00000000000000000000000000000000"
 
-# The qbraid mock server in utils/mock_qpu/qbraid/__init__.py doesn't simulate
+# The qbraid mock server in python/tests/utils/mock_qpu/qbraid/__init__.py doesn't simulate
 # quantum mechanics - it only inspects the QASM for `h` and `measure` ops and
 # generates random outcomes for qubits with H. It does NOT model entanglement
 # via CNOT. Assertions below reflect the mock's behavior, not physical truth.

python/tests/backends/test_scaleway_mock.py

@@ -24,11 +24,7 @@
 DEFAULT_SHOT_COUNT = 3000
 DEFAULT_DEDUPLICATION_ID = "cudaq-test-scaleway"
 
-try:
-    from utils.mock_qpu.scaleway import startServer
-except:
-    pytest.skip("Mock qpu not available, skipping Scaleway tests.",
-                allow_module_level=True)
+from utils.mock_qpu.scaleway import startServer
 
 
 @pytest.fixture(scope="session", autouse=True)

python/tests/backends/test_tii_mock.py

@@ -20,11 +20,7 @@
     not (cudaq.has_target("tii")),
     reason='Could not find `tii` in installation')
 
-try:
-    from utils.mock_qpu.tii import startServer
-except:
-    print("Mock qpu not available, skipping tii tests.")
-    pytest.skip("Mock qpu not available.", allow_module_level=True)
+from utils.mock_qpu.tii import startServer
 
 # Define the port for the mock server - make sure this is unique
 # across all tests.

python/tests/utils/__init__.py

@@ -0,0 +1,7 @@
+# ============================================================================ #
+# Copyright (c) 2026 NVIDIA Corporation & Affiliates.                          #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #

unittests/backends/anyon/AnyonStartServerAndTest.sh.in

@@ -21,7 +21,7 @@
 # EOF
 # }
 
-# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/anyon) under main/utils
+# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/anyon) under python/test/utils
 checkServerConnection() {
   PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ - << EOF
 import socket
@@ -34,9 +34,9 @@ except Exception:
 EOF
 }
 
-# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/anyon) under main/utils
+# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/anyon) under python/test/utils
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py anyon &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py anyon &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/braket/BraketStartServerAndTest.sh.in

@@ -21,7 +21,7 @@
 # EOF
 # }
 
-# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/braket) under main/utils
+# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/braket) under python/test/utils
 checkServerConnection() {
   PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ - << EOF
 import socket
@@ -34,9 +34,9 @@ except Exception:
 EOF
 }
 
-# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/braket) under main/utils
+# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/braket) under python/test/utils
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py braket &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py braket &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/infleqtion/InfleqtionStartServerAndTest.sh.in

@@ -21,7 +21,7 @@ EOF
 }
 
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py infleqtion &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py infleqtion &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/ionq/IonQStartServerAndTest.sh.in

@@ -21,7 +21,7 @@ EOF
 }
 
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py ionq &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py ionq &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/iqm/IQMStartServerAndTest.sh.in

@@ -30,9 +30,9 @@ EOF
 
 # Create fake auth tokens file
 tmp_file=$(mktemp)
-@Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/mock_qpu/iqm/mock_iqm_cortex_cli.py $tmp_file
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/mock_qpu/iqm/mock_iqm_cortex_cli.py $tmp_file
 # Launch the fake server
-@Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py iqm &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py iqm &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/oqc/OQCStartServerAndTest.sh.in

@@ -22,7 +22,7 @@ EOF
 
 @Python_EXECUTABLE@ -m pip install requests llvmlite
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py oqc &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py oqc &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/qbraid/QbraidStartServerAndTest.sh.in

@@ -21,7 +21,7 @@ EOF
 }
 
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/mock_qpu/qbraid/__init__.py &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/mock_qpu/qbraid/__init__.py &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/qci/QCIStartServerAndTest.sh.in

@@ -22,7 +22,7 @@ EOF
 
 
 # Launch the mock server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py qci &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py qci &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/quantinuum/QuantinuumStartServerAndTest.sh.in

@@ -20,7 +20,7 @@ except Exception:
 EOF
 }
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py quantinuum &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py quantinuum &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/quantinuum/QuantinuumStartServerAndTestNvqpp.sh.in

@@ -20,7 +20,7 @@ except Exception:
 EOF
 }
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py quantinuum &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py quantinuum &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/quantum_machines/QuantumMachinesStartServerAndTest.sh.in

@@ -21,7 +21,7 @@ EOF
 }
 
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py quantum_machines &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py quantum_machines &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/scaleway/ScalewayStartServerAndTest.sh.in

@@ -29,9 +29,9 @@ except Exception:
 EOF
 }
 
-# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/scaleway) under main/utils
+# Uncomment this and connect to mock_qpu backend server within the container (mock_qpu/scaleway) under python/test/utils
 # Launch the fake server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py scaleway &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py scaleway &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0

unittests/backends/tii/TiiStartServerAndTest.sh.in

@@ -22,7 +22,7 @@ EOF
 
 
 # Launch the mock server
-PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_SOURCE_DIR@/utils/start_mock_qpu.py tii &
+PYTHONPATH=@CMAKE_BINARY_DIR@/python @Python_EXECUTABLE@ @CMAKE_BINARY_DIR@/python/tests/utils/start_mock_qpu.py tii &
 # we'll need the process id to kill it
 pid=$(echo "$!")
 n=0