👷 Update C++ test matrices (#874)

Author: denialhaag

.github/workflows/ci.yml

@@ -88,16 +88,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        runs-on:
-          [ubuntu-22.04, ubuntu-24.04, ubuntu-22.04-arm, ubuntu-24.04-arm]
-        compiler: [gcc, clang, clang-19, clang-20]
+        runs-on: [ubuntu-24.04, ubuntu-24.04-arm]
+        compiler: [gcc, clang, clang-20, clang-21]
         config: [Release, Debug]
-        exclude:
-          # both combinations do not support C++20 due to the compiler being too old
-          - runs-on: ubuntu-22.04
-            compiler: clang
-          - runs-on: ubuntu-22.04-arm
-            compiler: clang
     uses: munich-quantum-toolkit/workflows/.github/workflows/reusable-cpp-tests-ubuntu.yml@89734354f64f30a80dd16602d4e271df34348987 # v1.17.4
     with:
       runs-on: ${{ matrix.runs-on }}
@@ -113,15 +106,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        runs-on: [macos-14, macos-15-intel, macos-15]
-        compiler: [clang, clang-19, clang-20, gcc-14, gcc-15]
+        runs-on: [macos-14, macos-15, macos-15-intel]
+        compiler: [clang, clang-20, clang-21, gcc-14, gcc-15]
         config: [Release, Debug]
-        exclude:
-          # see https://github.com/munich-quantum-toolkit/core/issues/979
-          - runs-on: macos-15
-            compiler: gcc-14
-          - runs-on: macos-15
-            compiler: gcc-15
     uses: munich-quantum-toolkit/workflows/.github/workflows/reusable-cpp-tests-macos.yml@89734354f64f30a80dd16602d4e271df34348987 # v1.17.4
     with:
       runs-on: ${{ matrix.runs-on }}
@@ -211,10 +198,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        runs-on: [ubuntu-22.04, ubuntu-22.04-arm, macos-15, windows-2025]
-        exclude:
-          # see https://github.com/munich-quantum-toolkit/qmap/issues/703
-          - runs-on: macos-15
+        runs-on: [macos-15, windows-2025]
     uses: munich-quantum-toolkit/workflows/.github/workflows/reusable-python-tests.yml@89734354f64f30a80dd16602d4e271df34348987 # v1.17.4
     with:
       runs-on: ${{ matrix.runs-on }}

CHANGELOG.md

@@ -13,11 +13,19 @@ _If you are upgrading: please see [`UPGRADING.md`](UPGRADING.md#unreleased)._
 
 ### Changed
 
+- 👷 Stop testing on `ubuntu-22.04` and `ubuntu-22.04-arm` runners ([#874]) ([**@denialhaag**])
+- 👷 Stop testing with `clang-19` and start testing with `clang-21` ([#874]) ([**@denialhaag**])
+- 👷 Fix macOS tests with Homebrew Clang via new `munich-quantum-toolkit/workflows` version ([#874]) ([**@denialhaag**])
+- 👷 Re-enable macOS tests with GCC by disabling module scanning ([#874]) ([**@denialhaag**])
 - ✨ Enable code generation for relaxed routing constraints ([#848]) ([**@ystade**])
 - ✨ Add `max_filling_factor` to scheduler in Zoned Neutral Atom Compiler ([#847]) ([**@ystade**])
 - ✨ Added extension to the hybrid routing mapper to also support Bridge gates, Passby moves and Flying ancillas ([#832]) ([**@lsschmid**])
 - ✨ Added hybrid synthesis routing for iterative circuit constructions ([#832]) ([**@lsschmid**])
 
+### Removed
+
+- 🔥 Remove wheel builds for Python 3.13t ([#874]) ([**@denialhaag**])
+
 ## [3.4.0] - 2025-10-15
 
 _If you are upgrading: please see [`UPGRADING.md`](UPGRADING.md#340)._
@@ -160,6 +168,7 @@ _📚 Refer to the [GitHub Release Notes] for previous changelogs._
 
 <!-- PR links -->
 
+[#874]: https://github.com/munich-quantum-toolkit/qmap/pull/874
 [#848]: https://github.com/munich-quantum-toolkit/qmap/pull/848
 [#847]: https://github.com/munich-quantum-toolkit/qmap/pull/847
 [#832]: https://github.com/munich-quantum-toolkit/qmap/pull/832

CMakeLists.txt

@@ -74,6 +74,18 @@ endif()
 
 option(BUILD_MQT_QMAP_TESTS "Also build tests for the MQT QMAP project" ${MQT_QMAP_MASTER_PROJECT})
 
+# on macOS with GCC, disable module scanning
+# https://www.reddit.com/r/cpp_questions/comments/1kwlkom/comment/ni5angh/
+if(CMAKE_SYSTEM_NAME STREQUAL "Darwin" AND CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+  if(CMAKE_VERSION VERSION_GREATER_EQUAL "3.28")
+    set(CMAKE_CXX_SCAN_FOR_MODULES OFF)
+  else()
+    message(WARNING "CMake 3.28+ is required to disable C++ module scanning on macOS with GCC. "
+                    "Current version: ${CMAKE_VERSION}. "
+                    "Consider upgrading CMake to avoid potential build issues.")
+  endif()
+endif()
+
 include(cmake/ExternalDependencies.cmake)
 
 # set the include directory for the build tree

UPGRADING.md

@@ -20,6 +20,13 @@ Enabling/increasing the corresponding parameters allows enabling individually si
 
 The hybrid mapper now also optionally yields a `.naviz` output which can be handled similarly to the zoned architecture compiler.
 
+### Removal of Python 3.13t wheels
+
+Free-threading Python was introduced as an experimental feature in Python 3.13.
+It became stable in Python 3.14.
+To conserve space on PyPI and to reduce the CD build times, we have removed all wheels for Python 3.13t from our CI.
+We continue to provide wheels for the regular Python versions 3.10 to 3.14, as well as 3.14t.
+
 ## [3.4.0]
 
 ### End of support for Python 3.9

pyproject.toml

@@ -316,7 +316,7 @@ ignore = ["GH200"]
 
 [tool.cibuildwheel]
 build = "cp3*"
-skip = "*-musllinux*"
+skip = ["*-musllinux_*", "cp313t-*"]
 archs = "auto64"
 test-groups = ["test"]
 test-command = "pytest {project}/test/python"
@@ -327,7 +327,7 @@ manylinux-aarch64-image = "manylinux_2_28"
 manylinux-ppc64le-image = "manylinux_2_28"
 manylinux-s390x-image = "manylinux_2_28"
 test-skip = [
-  "cp3*t-*", # no freethreading qiskit wheels
+  "cp3??t-*", # no freethreading qiskit wheels
   "cp*-win_arm64", # no numpy, qiskit, ... wheels
 ]
 
@@ -353,7 +353,7 @@ environment = { MACOSX_DEPLOYMENT_TARGET = "11.0" }
 repair-wheel-command = "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel} --ignore-missing-dependencies"
 
 [tool.cibuildwheel.windows]
-before-build = "uv pip install delvewheel>=1.9.0"
+before-build = "uv pip install delvewheel>=1.11.2"
 repair-wheel-command = """delvewheel repair -w {dest_dir} {wheel} --namespace-pkg mqt \
 --exclude mqt-core-ir.dll \
 --exclude mqt-core-qasm.dll \