♻️ Replace pybind11 with nanobind (#248)

* Update mqt-core

* Replace pybind11 with nanobind

* Enable Stable ABI wheels

* Auto-generate stub file

* Ignore linter errors

* Clean up docstrings

* Simplify ExternalDependencies.cmake

* Improve stubs session

Author: denialhaag

.github/workflows/ci.yml

@@ -88,7 +88,7 @@ jobs:
       clang-version: 20
       cmake-args: -DBUILD_MQT_DEBUGGER_BINDINGS=ON
       files-changed-only: true
-      install-pkgs: "pybind11==3.0.1"
+      install-pkgs: "nanobind==2.10.2"
       setup-python: true
       cpp-linter-extra-args: "-std=c++20"
 
@@ -125,6 +125,8 @@ jobs:
     needs: change-detection
     if: fromJSON(needs.change-detection.outputs.run-python-tests)
     uses: munich-quantum-toolkit/workflows/.github/workflows/reusable-python-linter.yml@d6314c45667c131055a0389afc110e8dedc6da3f # v1.17.11
+    with:
+      check-stubs: true
 
   build-sdist:
     name: 🚀 CD

CMakeLists.txt

@@ -42,10 +42,8 @@ if(BUILD_MQT_DEBUGGER_BINDINGS)
       CACHE BOOL "Prevent multiple searches for Python and instead cache the results.")
 
   # top-level call to find Python
-  find_package(
-    Python 3.10 REQUIRED
-    COMPONENTS Interpreter Development.Module
-    OPTIONAL_COMPONENTS Development.SABIModule)
+  find_package(Python 3.10 REQUIRED COMPONENTS Interpreter Development.Module
+                                               ${SKBUILD_SABI_COMPONENT})
 endif()
 
 include(cmake/ExternalDependencies.cmake)

bindings/CMakeLists.txt

@@ -5,7 +5,7 @@
 #
 # Licensed under the MIT License
 
-add_mqt_python_binding(
+add_mqt_python_binding_nanobind(
   DEBUGGER
   ${MQT_DEBUGGER_TARGET_NAME}-bindings
   bindings.cpp
@@ -16,5 +16,4 @@ add_mqt_python_binding(
   INSTALL_DIR
   .
   LINK_LIBS
-  MQT::Debugger
-  pybind11_json)
+  MQT::Debugger)