multi environments ci workflow

.github/workflows/multi.yml

@@ -0,0 +1,66 @@
+name: Qrisp unit tests via Pytest Windows and macOS
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Test Py${{ matrix.python-version }} on ${{ matrix.os }} (${{ matrix.test-group-name }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 120
+    strategy:
+      fail-fast: false
+      matrix:
+        # Actual dimensions that need to be multiplied out
+        os: [macos-latest, windows-latest]
+        python-version: ["3.11.*", "3.12.*", "3.13.*"]
+        test-group-name: [core, algorithms-and-integrations]
+
+        include:
+          # Map paths to test groups globally
+          - test-group-name: core
+            test-group-paths: "tests/circuit_tests tests/core_tests tests/primitives_tests tests/jax_tests tests/test_typing.py"
+          - test-group-name: algorithms-and-integrations
+            test-group-paths: "tests/algorithms_tests tests/operators_tests tests/block_encodings_tests tests/interface_tests tests/stim_integration_tests"
+
+          # Assign pip-extras based on OS type
+          - os: macos-latest
+            pip-extras: "[dev,catalyst,xdsl,iqm]"
+          - os: windows-latest
+            pip-extras: "[dev-windows,xdsl,iqm]"
+
+          # Inject specific pytest flags for Windows test groups
+          - os: windows-latest
+            test-group-name: core
+            # Exclude tests that are not supported on Windows due to platform-specific issues
+            pytest-flags: '-k "not test_catalyst_interface and not test_qubit_array_fusion"'          
+          - os: windows-latest
+            # Exclude tests that are not supported on Windows due to platform-specific issues
+            test-group-name: algorithms-and-integrations
+            pytest-flags: '--ignore=tests/interface_tests/test_converter_qrisp_to_qml.py'
+
+    steps:  
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+      - name: Install dependencies
+        shell: bash
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".${{ matrix.pip-extras }}"
+      - name: Test with pytest (${{ matrix.test-group-name }})
+        shell: bash
+        run: |
+          pytest ${{ matrix.test-group-paths }} ${{ matrix.pytest-flags }}

documentation/source/general/changelog/changelog-dev.rst

@@ -837,6 +837,9 @@ Development
   gate now running on both pull requests and pushes to ``main``
   (`PR #836 <https://github.com/eclipse-qrisp/Qrisp/pull/836>`_).
 
+* Added a CI test workflow for macOS and Windows, in addition to the existing Linux workflow.
+  The new ``multi.yml`` workflow runs on Python 3.11, 3.12, and 3.13 on the latest macOS and Windows runners.
+  (`PR #697 <https://github.com/eclipse-qrisp/Qrisp/pull/697>`_).
 * Added a ``docs build`` workflow that builds the Sphinx documentation on pull
   requests and treats any warning as an error. Building it fresh surfaced and
   fixed several issues: numpydoc-unknown docstring sections (``Properties``,

documentation/source/reference/Development Guide/getting_started.rst

@@ -28,14 +28,30 @@ For development you will also want the test and documentation dependencies:
 
     pip install -e ".[dev,docs]"
 
+**Windows**
+
+.. note::
+    The ``dev`` dependency group includes ``pyscf``, which is not supported on Windows. Windows users must install the compatible dependencies individually:
+
+.. code-block:: bash
+
+    # Install optional dependency groups (excluding dev)
+    pip install -e ".[docs,iqm,xdsl,aqt,qiskit]"
+
+    # Install Windows-compatible testing framework tools
+    pip install pytest qiskit-aer cirq pytest-httpx stim
+
+    # Install tqecd from source
+    python -m pip install git+https://github.com/tqec/tqecd.git
+
 .. list-table:: Optional dependency groups
    :header-rows: 1
    :widths: 15 40
 
    * - Group
      - What it installs
    * - ``dev``
-     - Test runner (pytest), simulators (qiskit-aer, cirq), and chemistry (pyscf)
+     - Test runner (pytest), simulators (qiskit-aer, cirq), and chemistry (pyscf *(Not supported on Windows)*)
    * - ``docs``
      - Sphinx and related extensions for building the documentation
    * - ``aqt``
@@ -45,7 +61,7 @@ For development you will also want the test and documentation dependencies:
    * - ``iqm``
      - Client for IQM quantum hardware
    * - ``catalyst``
-     - PennyLane Catalyst JIT compiler
+     - PennyLane Catalyst JIT compiler *(Not supported on Windows)*
    * - ``xdsl``
      - xDSL compiler infrastructure
    * - ``all``
@@ -57,7 +73,7 @@ Include the groups you need in brackets, either at install time or later:
 
 .. code-block:: bash
 
-    # Everything (base install plus every optional group)
+    # Everything (base install plus every optional group) (Linux/macOS)
     pip install -e ".[all]"
 
     # Or individual groups after the base install
@@ -84,11 +100,27 @@ Running the test suite
 Before making any changes, confirm that the existing test suite passes on your
 machine. This gives you a clean baseline to compare against.
 
+**Linux and macOS**
+
 .. code-block:: bash
 
     # Run the full suite (note: this currently takes up to ~1 hour)
     pytest tests/
 
+**Windows**
+
+.. note::
+    Because certain unsupported dependencies are missing on Windows, you must ignore specific interface and JAX tests when running the suite:
+
+.. code-block:: bash
+
+    # Run the full suite while ignoring unsupported dependency tests
+    pytest tests/ --ignore=tests/interface_tests/test_converter_qrisp_to_qml.py --ignore=tests/jax_tests/test_catalyst_interface.py --ignore=tests/jax_tests/test_qubit_array_fusion.py
+
+**Subsystem testing (All Platforms)**
+
+.. code-block:: bash
+
     # Run only a specific subsystem — much faster during development
     pytest tests/circuit_tests/
 

pyproject.toml

@@ -74,18 +74,25 @@ docs = [
 dev-code-style = [
     "ruff==0.17.0",
 ]
-dev-testing = [
+dev-testing-windows = [
     "pytest==9.1.1",
     "pytest-cov>=6.0",
     "qiskit-aer",
-    "pyscf",
     "cirq",
     "tqecd",
     "iqm-client[qrisp]>=35.0.0",
 ]
+dev-testing = [
+    "qrisp[dev-testing-windows]",
+    "pyscf",
+]
 dev = [
     "qrisp[dev-code-style,dev-testing]",
 ]
+dev-windows = [
+    "qrisp[dev-code-style, dev-testing-windows]",
+]
+
 # aqt is intentionally excluded from `all` because qiskit-aqt-provider ships a
 # pytest plugin (qiskit_aqt_provider.test.fixtures) that fails to load when
 # pytest-httpx is not installed, breaking any pytest invocation. 
@@ -151,4 +158,4 @@ ignore = [
 omit = ["*/__init__.py"]
 
 [tool.pylint. messages_control]
-disable = ["import-error"]
+disable = ["import-error"]