Merge branch 'wjakob:master' into master

Author: MaxwellGengYF

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
       fail-fast: false
       matrix:
         os: ['ubuntu-latest', 'windows-2022', 'macos-13']
-        python: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14.0-rc.2', 'pypy3.9-v7.3.16', 'pypy3.10-v7.3.17']
+        python: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14', 'pypy3.9-v7.3.16', 'pypy3.10-v7.3.17']
 
     name: "Python ${{ matrix.python }} / ${{ matrix.os }}"
     runs-on: ${{ matrix.os }}
@@ -107,98 +107,180 @@ jobs:
         cd build;
         python3 -m pytest
 
-  old-compilers:
-    if: false # Disable for now, the CI is glitchy
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - cc: gcc-8
-            cxx: g++-8
-            apt: gcc-8 g++-8
-          - cc: gcc-9
-            cxx: g++-9
-            apt: gcc-9
-          - cc: clang-8
-            cxx: clang++-8
-            apt: clang-8
-          - cc: clang-9
-            cxx: clang++-9
-            apt: clang-9
-          - cc: clang-10
-            cxx: clang++-10
-            apt: clang-10
-
+  free-threaded:
+    name: "Python 3.14-dev / ubuntu.latest [free-threaded]"
     runs-on: ubuntu-latest
-    container: ubuntu:20.04
-    name: "${{matrix.cc}} on Ubuntu 20.04"
-    env:
-      CC: ${{matrix.cc}}
-      CXX: ${{matrix.cxx}}
-      DEBIAN_FRONTEND: noninteractive
 
     steps:
-    - name: Install dependencies
-      run: |
-        apt-get update
-        apt-get install -y python3-numpy python3-pip python3-pytest libeigen3-dev cmake git ${{matrix.apt}}
-        python3 -m pip install typing_extensions
-
     - uses: actions/checkout@v4
       with:
         submodules: true
 
+    - uses: deadsnakes/action@v3.1.0
+      with:
+        python-version: 3.14-dev
+        nogil: true
+
+    - name: Install the latest CMake
+      uses: lukka/get-cmake@latest
+
+    - name: Install PyTest
+      run: |
+        python -m pip install pytest pytest-github-actions-annotate-failures
+
     - name: Configure
-      run: cmake -S . -B build
+      run: >
+        cmake -S . -B build -DNB_TEST_FREE_THREADED=ON
 
     - name: Build C++
-      run: cmake --build build -j 2
+      run: >
+        cmake --build build -j 2
 
     - name: Check ABI tag
       run: >
         cd build/tests;
-        python3 -c 'import test_functions_ext as t; print(f"ABI tag is \"{ t.abi_tag() }\"")'
+        python -c 'import test_functions_ext as t; print(f"ABI tag is \"{ t.abi_tag() }\"")'
 
     - name: Run tests
       run: >
         cd build;
-        python3 -m pytest
+        python -m pytest
 
-  free-threaded:
-    name: "Python 3.14-dev / ubuntu.latest [free-threaded]"
-    runs-on: ubuntu-latest
+  mingw:
+    runs-on: windows-2022
+    name: "Python ${{ matrix.python }} / MinGW-w64"
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.12']
 
     steps:
     - uses: actions/checkout@v4
       with:
         submodules: true
 
-    - uses: deadsnakes/action@v3.1.0
+    - name: Setup Python ${{ matrix.python }}
+      uses: actions/setup-python@v5
       with:
-        python-version: 3.14-dev
-        nogil: true
+        python-version: ${{ matrix.python }}
+        cache: 'pip'
+
+    - name: Setup MSYS2 (MINGW64)
+      uses: msys2/setup-msys2@v2
+      with:
+        msystem: MINGW64
+        install: >-
+          mingw-w64-x86_64-gcc
+          mingw-w64-x86_64-cmake
+          mingw-w64-x86_64-ninja
+          mingw-w64-x86_64-python
+          mingw-w64-x86_64-python-pip
+          mingw-w64-x86_64-python-pytest
+
+    - name: Install Python packages
+      shell: msys2 {0}
+      run: |
+        python -m pip install pytest-github-actions-annotate-failures typing_extensions
+
+    - name: Configure
+      shell: msys2 {0}
+      run: |
+        export PATH=/mingw64/bin:$PATH
+        export CC=gcc
+        export CXX=g++
+        PYEXE=/mingw64/bin/python3.exe
+        cmake -S . -B build -G Ninja \
+          -DPython_EXECUTABLE="$(cygpath -w "$PYEXE")" \
+          -DNB_TEST_FREE_THREADED=OFF
+
+    - name: Build C++
+      shell: msys2 {0}
+      run: cmake --build build -j 2
+
+    - name: Check ABI tag
+      shell: msys2 {0}
+      run: |
+        cd build/tests
+        python -c 'import test_functions_ext as t; print(f"ABI tag is \"{t.abi_tag()}\"")'
+
+    - name: Run tests
+      shell: msys2 {0}
+      run: |
+        cd build
+        python -m pytest
+
+  intel:
+    runs-on: ubuntu-22.04
+    name: "Python ${{ matrix.python }} / Intel ICX"
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.12']
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        submodules: true
+
+    - name: Setup Python ${{ matrix.python }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python }}
+        cache: 'pip'
+
+    - name: Cache Intel oneAPI
+      id: cache-oneapi
+      uses: actions/cache@v4
+      with:
+        path: /opt/intel/oneapi
+        key: install-${{ runner.os }}-intel-oneapi-compiler-2025.2
+
+    - name: Add Intel repository
+      if: steps.cache-oneapi.outputs.cache-hit != 'true'
+      run: |
+        wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg > /dev/null
+        echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
+        sudo apt-get update
+
+    - name: Install Intel oneAPI compilers
+      if: steps.cache-oneapi.outputs.cache-hit != 'true'
+      run: |
+        sudo apt-get install -y intel-oneapi-compiler-dpcpp-cpp
+
+    - name: Cleanup Intel oneAPI cache
+      if: steps.cache-oneapi.outputs.cache-hit != 'true'
+      run: |
+        sudo rm -rf /opt/intel/oneapi/compiler/*/linux/lib/ia32
+        sudo rm -rf /opt/intel/oneapi/compiler/*/linux/lib/emu
+        sudo rm -rf /opt/intel/oneapi/compiler/*/linux/lib/oclfpga
 
     - name: Install the latest CMake
       uses: lukka/get-cmake@latest
 
     - name: Install PyTest
       run: |
-        python -m pip install pytest pytest-github-actions-annotate-failures
+        python -m pip install pytest pytest-github-actions-annotate-failures typing_extensions
 
     - name: Configure
-      run: >
-        cmake -S . -B build -DNB_TEST_FREE_THREADED=ON
+      run: |
+        source /opt/intel/oneapi/setvars.sh
+        export CC=icx
+        export CXX=icpx
+        cmake -S . -B build
 
     - name: Build C++
-      run: >
+      run: |
+        source /opt/intel/oneapi/setvars.sh
         cmake --build build -j 2
 
     - name: Check ABI tag
-      run: >
-        cd build/tests;
+      run: |
+        source /opt/intel/oneapi/setvars.sh
+        cd build/tests
         python -c 'import test_functions_ext as t; print(f"ABI tag is \"{ t.abi_tag() }\"")'
 
     - name: Run tests
-      run: >
-        cd build;
+      run: |
+        source /opt/intel/oneapi/setvars.sh
+        cd build
         python -m pytest

cmake/nanobind-config.cmake

@@ -590,7 +590,7 @@ endfunction()
 # ---------------------------------------------------------------------------
 
 function (nanobind_add_stub name)
-  cmake_parse_arguments(PARSE_ARGV 1 ARG "VERBOSE;INCLUDE_PRIVATE;EXCLUDE_DOCSTRINGS;INSTALL_TIME;RECURSIVE;EXCLUDE_FROM_ALL" "MODULE;COMPONENT;PATTERN_FILE;OUTPUT_PATH" "PYTHON_PATH;DEPENDS;MARKER_FILE;OUTPUT")
+  cmake_parse_arguments(PARSE_ARGV 1 ARG "VERBOSE;INCLUDE_PRIVATE;EXCLUDE_DOCSTRINGS;EXCLUDE_VALUES;INSTALL_TIME;RECURSIVE;EXCLUDE_FROM_ALL" "MODULE;COMPONENT;PATTERN_FILE;OUTPUT_PATH" "PYTHON_PATH;DEPENDS;MARKER_FILE;OUTPUT")
 
   if (EXISTS ${NB_DIR}/src/stubgen.py)
     set(NB_STUBGEN "${NB_DIR}/src/stubgen.py")
@@ -614,6 +614,10 @@ function (nanobind_add_stub name)
     list(APPEND NB_STUBGEN_ARGS -D)
   endif()
 
+  if (ARG_EXCLUDE_VALUES)
+    list(APPEND NB_STUBGEN_ARGS --exclude-values)
+  endif()
+
   if (ARG_RECURSIVE)
     list(APPEND NB_STUBGEN_ARGS -r)
   endif()

docs/api_extra.rst

@@ -1108,6 +1108,11 @@ convert into an equivalent representation in one of the following frameworks:
 
    Builtin Python ``memoryview`` for CPU-resident data.
 
+.. cpp:class:: array_api
+
+   An object that both implements the buffer protocol and also has the
+   ``__dlpack__`` and ``__dlpack_device__`` attributes.
+
 Eigen convenience type aliases
 ------------------------------
 
@@ -1561,6 +1566,16 @@ include directive:
    <https://docs.python.org/3/library/typing.html#typing.TypeVarTuple>`__
    (i.e., an instance of ``typing.TypeVarTuple``).
 
+.. cpp:function:: template <typename... Args> object param_spec(Args&&... args)
+
+   Analogous to :cpp:func:`type_var`, create a `parameter specification variable
+   <https://docs.python.org/3/library/typing.html#typing.ParamSpec>`__
+   (i.e., an instance of ``typing.ParamSpec``).
+
+   .. code-block:: cpp
+
+        m.attr("P") = nb::param_spec("P");
+
 .. cpp:function:: object any_type()
 
    Convenience wrapper, which returns ``typing.Any``.

docs/changelog.rst

@@ -15,6 +15,25 @@ case, both modules must use the same nanobind ABI version, or they will be
 isolated from each other. Releases that don't explicitly mention an ABI version
 below inherit that of the preceding release.
 
+Version TBD (not yet released)
+------------------------------
+
+- ABI version 17. The layout of the `nb_inst` class was changed to fix a data race
+  between `clear_keep_alive` and other bitfields in the same struct (PR `#1191
+  <https://github.com/wjakob/nanobind/pull/1191>`__)
+
+- Nanobind now officially supports **MinGW-w64** and **Intel ICX** (the modern
+  Clang-based Intel compiler). Continuous integration tests have been added to
+  ensure compatibility with these compilers on an ongoing basis.
+
+- The framework ``nb::array_api`` is now available to return an nd-array from
+  C++ to Python as an object that supports both the Python buffer protocol as
+  well as the DLPack methods ``__dlpack__`` and ``_dlpack_device__``.
+  Nanobind now supports importing and exporting nd-arrays via capsules that
+  contain the ``DLManagedTensorVersioned`` struct, which has a flag bit
+  indicating the nd-array is read-only.
+  (PR `#1175 <https://github.com/wjakob/nanobind/pull/1175>`__).
+
 Version 2.9.2 (Sep 4, 2025)
 ---------------------------
 

docs/index.rst

@@ -57,9 +57,10 @@ nanobinds depends on
 - **Python 3.8+** or **PyPy 7.3.10+** (the *3.8* and *3.9* PyPy flavors are
   supported, though there are :ref:`some limitations <pypy_issues>`).
 - **CMake 3.15+**.
-- **A C++17 compiler**: Clang 8+, GCC 8+, MSVC2019+, and the CUDA NVCC compiler
-  are officially supported. Others (MinGW, Cygwin, Intel, ..) may work as well
-  but will not receive support.
+- **A C++17 compiler**: Clang 8+, GCC 8+, MSVC2019+, MinGW-w64, Intel ICX
+  (the modern Clang-based Intel compiler), and the CUDA NVCC compiler are
+  officially supported. Others (Cygwin, older Intel compilers, ..) may work
+  as well but will not receive support.
 
 .. only:: not latex