cuda.core: prefer binding names for runtime errors

Use the generated runtime error enum as the name source for known CUDA Runtime errors so error messages remain stable when the runtime name table differs from the installed bindings.

Made-with: Cursor

Author: rwgk

cuda_core/cuda/core/_utils/cuda_utils.pyx

@@ -149,6 +149,13 @@ cdef object _RUNTIME_SUCCESS = runtime.cudaError_t.cudaSuccess
 cdef object _NVRTC_SUCCESS = nvrtc.nvrtcResult.NVRTC_SUCCESS
 
 
+def _known_runtime_error_name(error):
+    try:
+        return runtime.cudaError_t(error).name
+    except ValueError:
+        return None
+
+
 cpdef inline int _check_driver_error(cydriver.CUresult error) except?-1 nogil:
     if error == cydriver.CUresult.CUDA_SUCCESS:
         return 0
@@ -174,7 +181,9 @@ cpdef inline int _check_runtime_error(error) except?-1:
     name_err, name = runtime.cudaGetErrorName(error)
     if name_err != _RUNTIME_SUCCESS:
         raise CUDAError(f"UNEXPECTED ERROR CODE: {error}")
-    name = name.decode()
+    # Windows hybrid cudart can lag the generated bindings' enum table.
+    # Prefer the binding name for values the bindings know.
+    name = _known_runtime_error_name(error) or name.decode()
     expl = RUNTIME_CUDA_ERROR_EXPLANATIONS.get(int(error))
     if expl is not None:
         raise CUDAError(f"{name}: {expl}")

cuda_core/tests/test_cuda_utils.py

@@ -179,6 +179,22 @@ def test_check_runtime_error_attaches_explanation():
     assert str(e.value) != f"{name.decode()}: {desc.decode()}"
 
 
+def test_check_runtime_error_uses_binding_name_for_known_runtime_error(monkeypatch):
+    error = runtime.cudaError_t.cudaErrorInvalidValue
+    runtime_name = b"runtime-provided-name"
+
+    def cuda_get_error_name(_error):
+        return runtime.cudaError_t.cudaSuccess, runtime_name
+
+    monkeypatch.setattr(cuda_utils.runtime, "cudaGetErrorName", cuda_get_error_name)
+
+    with pytest.raises(cuda_utils.CUDAError) as e:
+        cuda_utils._check_runtime_error(error)
+
+    assert str(e.value).startswith(f"{error.name}: ")
+    assert runtime_name.decode() not in str(e.value)
+
+
 def test_precondition():
     def checker(*args, what=""):
         if args[0] < 0: