From 8bf29c39e42fb1237ea1cd83a41f68ac9617dee1 Mon Sep 17 00:00:00 2001 From: Michael Droettboom Date: Wed, 30 Sep 2026 15:44:47 -0400 Subject: [PATCH 1/2] Update Cython layer and ABI stability information Clarify Cython layer details and ABI stability for higher-level modules. --- cuda_bindings/docs/source/support.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/cuda_bindings/docs/source/support.rst b/cuda_bindings/docs/source/support.rst index 5c292eb5cb5..084046e5ed8 100644 --- a/cuda_bindings/docs/source/support.rst +++ b/cuda_bindings/docs/source/support.rst @@ -20,10 +20,13 @@ The ``cuda.bindings`` module has the following support policy: documentation.) 4. The module supports all Python versions following the `CPython EOL schedule`_. As of writing Python 3.10 - 3.14 are supported. -5. The module exposes a Cython layer from which types and functions could be ``cimport``'d. While - we strive to keep this layer stable, due to Cython limitations a new *minor* release of this - module could require Cython layer users to rebuild their projects and update their pinning to - this module. +5. The module exposes a Cython layer (modules beginning with the ``cy`` prefix) from which types and + functions can be ``cimport``'d. While we strive to keep this layer stable, due to Cython limitations + a new *minor* release of this module could require Cython layer users to rebuild their projects and + update their pinning to this module. +6. The higher-level modules in ``cuda.bindings`` (without the ``cy`` prefix) do not have any + ABI stability guarantees, so while they can be ``cimport``'d, they will require a rebuild for + a specific version of ``cuda.bindings``. Free-threading Build Support ---------------------------- From 34a7f288d7b536d65cc018f50d0b85e98c0ceb2b Mon Sep 17 00:00:00 2001 From: Michael Droettboom Date: Wed, 30 Sep 2026 17:16:56 -0400 Subject: [PATCH 2/2] Add note --- cuda_bindings/docs/source/support.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/cuda_bindings/docs/source/support.rst b/cuda_bindings/docs/source/support.rst index 084046e5ed8..8340e031f12 100644 --- a/cuda_bindings/docs/source/support.rst +++ b/cuda_bindings/docs/source/support.rst @@ -20,13 +20,13 @@ The ``cuda.bindings`` module has the following support policy: documentation.) 4. The module supports all Python versions following the `CPython EOL schedule`_. As of writing Python 3.10 - 3.14 are supported. -5. The module exposes a Cython layer (modules beginning with the ``cy`` prefix) from which types and +5. The module exposes a Cython layer (modules beginning with the ``cy`` prefix) from which types and functions can be ``cimport``'d. While we strive to keep this layer stable, due to Cython limitations - a new *minor* release of this module could require Cython layer users to rebuild their projects and + a new *minor* release of this module could require Cython layer users to rebuild their projects and update their pinning to this module. 6. The higher-level modules in ``cuda.bindings`` (without the ``cy`` prefix) do not have any ABI stability guarantees, so while they can be ``cimport``'d, they will require a rebuild for - a specific version of ``cuda.bindings``. + a specific version of ``cuda.bindings``. They do, however, have a stable API from a Python perspective. Free-threading Build Support ----------------------------