Merge branch 'main' into copilot/fix-760

Author: rwgk

cuda_bindings/docs/source/install.md

@@ -10,7 +10,7 @@
 * Optionally, NVRTC, nvJitLink, NVVM, and cuFile from CUDA Toolkit 13.x
 
 ```{note}
-The optional CUDA Toolkit components can be installed via PyPI, Conda, OS-specific package managers, or local installers (as described in the CUDA Toolkit [Windows](https://docs.nvidia.com/cuda/cuda-installation-guide-microsoft-windows/index.html) and [Linux](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html) Installation Guides).
+The optional CUDA Toolkit components are now installed via the `cuda-toolkit` metapackage from PyPI for improved dependency resolution. Components can also be installed via Conda, OS-specific package managers, or local installers (as described in the CUDA Toolkit [Windows](https://docs.nvidia.com/cuda/cuda-installation-guide-microsoft-windows/index.html) and [Linux](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html) Installation Guides).
 ```
 
 Starting from v12.8.0, `cuda-python` becomes a meta package which currently depends only on `cuda-bindings`; in the future more sub-packages will be added to `cuda-python`. In the instructions below, we still use `cuda-python` as example to serve existing users, but everything is applicable to `cuda-bindings` as well.
@@ -27,12 +27,14 @@ Install all optional dependencies with:
 pip install -U cuda-python[all]
 ```
 
-Where the optional dependencies are:
+Where the optional dependencies include:
 
-* nvidia-cuda-nvrtc (Provides NVRTC shared library)
-* nvidia-nvjitlink (Provides nvJitLink shared library)
-* nvidia-cuda-nvcc (Provides NVVM shared library)
-* nvidia-cufile (Provides cuFile shared library)
+* `nvidia-cuda-nvrtc` (NVRTC runtime compilation library)  
+* `nvidia-nvjitlink` (nvJitLink library)
+* `nvidia-nvvm` (NVVM library)
+* `nvidia-cufile` (cuFile library, Linux only)
+
+These are now installed through the `cuda-toolkit` metapackage for improved dependency resolution.
 
 
 ## Installing from Conda
@@ -41,6 +43,15 @@ Where the optional dependencies are:
 $ conda install -c conda-forge cuda-python
 ```
 
+```{note}
+When using conda, the `cuda-version` metapackage can be used to control the versions of CUDA Toolkit components that are installed to the conda environment.
+```
+
+For example:
+```console
+$ conda install -c conda-forge cuda-python cuda-version=13
+```
+
 
 ## Installing from Source
 

cuda_bindings/docs/source/release.rst

@@ -7,8 +7,10 @@ Release Notes
 .. toctree::
    :maxdepth: 3
 
+   13.X.Y <release/13.X.Y-notes.rst>
    13.0.1 <release/13.0.1-notes.rst>
    13.0.0 <release/13.0.0-notes.rst>
+   12.9.X <release/12.9.X-notes.rst>
    12.9.2 <release/12.9.2-notes.rst>
    12.9.1 <release/12.9.1-notes.rst>
    12.9.0 <release/12.9.0-notes.rst>

cuda_bindings/docs/source/release/12.9.X-notes.rst

@@ -0,0 +1,21 @@
+.. SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+.. SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
+
+.. module:: cuda.bindings
+
+``cuda-bindings`` 12.9.X Release notes
+======================================
+
+Released on TBD
+
+
+Highlights
+----------
+
+* Automatic CUDA library path detection based on ``CUDA_HOME``, eliminating the need to manually set ``LIBRARY_PATH`` environment variables for installation.
+
+
+Known issues
+------------
+
+* Updating from older versions (v12.6.2.post1 and below) via ``pip install -U cuda-python`` might not work. Please do a clean re-installation by uninstalling ``pip uninstall -y cuda-python`` followed by installing ``pip install cuda-python``.

cuda_bindings/docs/source/release/13.X.Y-notes.rst

@@ -0,0 +1,23 @@
+.. SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+.. SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
+
+.. module:: cuda.bindings
+
+``cuda-bindings`` 13.X.Y Release notes
+======================================
+
+Released on TBD
+
+
+Highlights
+----------
+
+* Migrated wheel dependencies from individual NVIDIA packages to the ``cuda-toolkit`` metapackage for improved dependency resolution and version constraints.
+* Automatic CUDA library path detection based on ``CUDA_HOME``, eliminating the need to manually set ``LIBRARY_PATH`` environment variables for installation.
+* The ``[all]`` optional dependencies now use ``cuda-toolkit`` with appropriate extras instead of individual packages. The NVCC compiler is no longer automatically installed with ``pip install cuda-python[all]`` as it was previously included only to access the NVVM library, which now has its own dedicated wheel. Users who need the NVCC compiler should explicitly install it with ``pip install cuda-toolkit[nvcc]==X.Y`` with the appropriate version for their needs.
+
+
+Known issues
+------------
+
+* Updating from older versions (v12.6.2.post1 and below) via ``pip install -U cuda-python`` might not work. Please do a clean re-installation by uninstalling ``pip uninstall -y cuda-python`` followed by installing ``pip install cuda-python``.

cuda_bindings/pyproject.toml

@@ -33,11 +33,8 @@ dependencies = [
 
 [project.optional-dependencies]
 all = [
-    "nvidia-cuda-nvcc~=13.0",
-    "nvidia-cuda-nvrtc~=13.0",
-    "nvidia-nvjitlink~=13.0",
-    "nvidia-nvvm~=13.0",
-    "nvidia-cufile; sys_platform == 'linux'",
+    "cuda-toolkit[nvrtc,nvjitlink,nvvm]==13.*",
+    "cuda-toolkit[cufile]==13.*; sys_platform == 'linux'",
 ]
 
 test = [

cuda_core/cuda/core/experimental/_linker.py

@@ -205,15 +205,15 @@ def _init_nvjitlink(self):
             self.formatted_options.append("-time")
         if self.verbose is not None:
             self.formatted_options.append("-verbose")
-        if self.link_time_optimization is not None:
+        if self.link_time_optimization is not None and self.link_time_optimization:
             self.formatted_options.append("-lto")
         if self.ptx is not None:
             self.formatted_options.append("-ptx")
         if self.optimization_level is not None:
             self.formatted_options.append(f"-O{self.optimization_level}")
-        if self.debug is not None:
+        if self.debug is not None and self.debug:
             self.formatted_options.append("-g")
-        if self.lineinfo is not None:
+        if self.lineinfo is not None and self.lineinfo:
             self.formatted_options.append("-lineinfo")
         if self.ftz is not None:
             self.formatted_options.append(f"-ftz={'true' if self.ftz else 'false'}")

cuda_core/cuda/core/experimental/_program.py

@@ -244,8 +244,8 @@ def __post_init__(self):
             self._formatted_options.append("--device-debug")
         if self.lineinfo is not None and self.lineinfo:
             self._formatted_options.append("--generate-line-info")
-        if self.device_code_optimize is not None:
-            self._formatted_options.append(f"--dopt={'on' if self.device_code_optimize else 'off'}")
+        if self.device_code_optimize is not None and self.device_code_optimize:
+            self._formatted_options.append("--dopt=on")
         if self.ptxas_options is not None:
             opt_name = "--ptxas-options"
             if isinstance(self.ptxas_options, str):
@@ -351,7 +351,7 @@ def _as_bytes(self):
 
     def __repr__(self):
         # __TODO__ improve this
-        return self._formatted_options
+        return str(self._formatted_options)
 
 
 ProgramHandleT = Union["cuda.bindings.nvrtc.nvrtcProgram", LinkerHandleT]

cuda_core/docs/source/api.rst

@@ -7,7 +7,7 @@
 ========================================
 
 All of the APIs listed (or cross-referenced from) below are considered *experimental*
-and subject to future changes without deprecation notice. Once stablized they will be
+and subject to future changes without deprecation notice. Once stabilized they will be
 moved out of the ``experimental`` namespace.
 
 

cuda_core/docs/source/install.md

@@ -17,11 +17,11 @@ dependencies are as follows:
 
 ## Installing from PyPI
 
-`cuda.core` works with `cuda.bindings` (part of `cuda-python`) 11 or 12. For example with CUDA 12:
+`cuda.core` works with `cuda.bindings` (part of `cuda-python`) 11 or 12. Test dependencies now use the ``cuda-toolkit`` metapackage for improved dependency resolution. For example with CUDA 12:
 ```console
 $ pip install cuda-core[cu12]
 ```
-and likewise use `[cu11]` for CUDA 11.
+and likewise use `[cu11]` for CUDA 11, or `[cu13]` for CUDA 13.
 
 Note that using `cuda.core` with NVRTC installed from PyPI via `pip install` requires
 `cuda.bindings` 12.8.0+ or 11.8.6+. Likewise, with nvJitLink it requires 12.8.0+.

cuda_core/docs/source/release/0.X.Y-notes.rst

@@ -25,6 +25,7 @@ New features
 ------------
 
 - Added :attr:`Device.arch` property that returns the compute capability as a string (e.g., '75' for CC 7.5), providing a convenient alternative to manually concatenating the compute capability tuple.
+- CUDA 13.x testing support through new ``test-cu13`` dependency group.
 
 
 New examples