cuda_core: prefer enum explanations from cuda.bindings, keep local fallback (#1712)

Each explanation module now tries to import the authoritative dict from
cuda.bindings._utils (ModuleNotFoundError-guarded) and falls back to its
own copy for older cuda-bindings that don't ship it yet. Smoke tests
added for both dicts.

Made-with: Cursor

Author: rwgk

cuda_core/cuda/core/_utils/driver_cu_result_explanations.py

@@ -1,11 +1,7 @@
 # SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
-# To regenerate the dictionary below run:
-#     ../../../../../toolshed/reformat_cuda_enums_as_py.py /usr/local/cuda/include/cuda.h
-# Replace the dictionary below with the output.
-# Also update the CUDA Toolkit version number below.
-
+# Fallback copy -- overridden from cuda.bindings below when available.
 # CUDA Toolkit v13.2.0
 DRIVER_CU_RESULT_EXPLANATIONS = {
     0: (
@@ -356,3 +352,11 @@
     ),
     999: "This indicates that an unknown internal error has occurred.",
 }
+
+# Prefer the authoritative copy from cuda.bindings when available.
+try:
+    import cuda.bindings._utils.driver_cu_result_explanations as _authoritative
+except ModuleNotFoundError:
+    pass
+else:
+    DRIVER_CU_RESULT_EXPLANATIONS = _authoritative.DRIVER_CU_RESULT_EXPLANATIONS

cuda_core/cuda/core/_utils/runtime_cuda_error_explanations.py

@@ -1,11 +1,7 @@
 # SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
-# To regenerate the dictionary below run:
-#     ../../../../../toolshed/reformat_cuda_enums_as_py.py /usr/local/cuda/include/driver_types.h
-# Replace the dictionary below with the output.
-# Also update the CUDA Toolkit version number below.
-
+# Fallback copy -- overridden from cuda.bindings below when available.
 # CUDA Toolkit v13.2.0
 RUNTIME_CUDA_ERROR_EXPLANATIONS = {
     0: (
@@ -549,3 +545,11 @@
         " This error return is deprecated as of CUDA 4.1."
     ),
 }
+
+# Prefer the authoritative copy from cuda.bindings when available.
+try:
+    import cuda.bindings._utils.runtime_cuda_error_explanations as _authoritative
+except ModuleNotFoundError:
+    pass
+else:
+    RUNTIME_CUDA_ERROR_EXPLANATIONS = _authoritative.RUNTIME_CUDA_ERROR_EXPLANATIONS

cuda_core/tests/test_cuda_utils.py

@@ -11,6 +11,20 @@
 from cuda.core._utils.clear_error_support import assert_type_str_or_bytes_like, raise_code_path_meant_to_be_unreachable
 
 
+def test_driver_cu_result_explanations_smoke():
+    expl = cuda_utils.DRIVER_CU_RESULT_EXPLANATIONS
+    for code in (0, 1, 2):
+        assert code in expl
+        assert isinstance(expl[code], str)
+
+
+def test_runtime_cuda_error_explanations_smoke():
+    expl = cuda_utils.RUNTIME_CUDA_ERROR_EXPLANATIONS
+    for code in (0, 1, 2):
+        assert code in expl
+        assert isinstance(expl[code], str)
+
+
 def test_check_driver_error():
     num_unexpected = 0
     for error in driver.CUresult: