You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
cuda.core: carry the cuda-bindings floors through minimal-sysctk12/13 extras - #3460
Moves the cuda-bindings floors from the cu12/cu13 extras into new minimal-sysctk12/minimal-sysctk13 extras, which cu12/cu13 include by self-reference. A package that depends on cuda-core[minimal-sysctk12] (or [cu12]) now passes the floor to pip and uv.
The floor readers (floors_from_extras and the CI wheel-floor reader) still read the floor of each cu<N> extra; they now follow a cuda-core[...] self-reference and skip an unversioned cuda-bindings[all]. The existing tests of the cu<N> form are unchanged, and new tests cover the self-reference.
Two additions beyond the issue:
The check-cuda-core-bindings-floor hook also checks that each cu<N> extra lists cuda-core[minimal-sysctk<N>], so the floor is written only in minimal-sysctk<N>.
[tool.uv].conflicts declares the new extras as conflicting across majors; without it uv lock fails.
A CUDA 12 wheel built from this branch carries the floors under extra == "minimal-sysctk12"/"minimal-sysctk13", and pip install --dry-run "cuda-core[cu12] @ <wheel>" cuda-bindings==12.9.3 (likewise [minimal-sysctk12]) is now rejected at resolve time instead of failing at import.
The floors lived only in the cu12/cu13 extras, so a package that depends
on plain cuda-core never passed them to pip or uv, and an older
cuda-bindings failed only at import (NVIDIA#3459).
Declare the floors in new minimal-sysctk12/13 extras, include them from
cu12/cu13, and depend on cuda-bindings without a version. The floor
parser, the CI wheel-floor reader, the pre-commit hook and the docs read
the new extras.
Drop the unversioned cuda-bindings from the base dependencies, so a
plain cuda-core install keeps asking for an extra.
Keep the floor readers on the cu<N> extras, as before, and teach them
to follow a cuda-core[...] self-reference and to skip an unversioned
cuda-bindings[all]. The cu<N> layout then yields the floor written in
minimal-sysctk<N>, and the existing tests of the cu<N> form stay as
they are. New tests cover the self-reference.
The reason will be displayed to describe this comment to others. Learn more.
Not reviewing either way (I think @Andy-Jost should probably weigh in) -- just sharing one note my agent found:
Stale wording in build_hooks.py. The docstrings near lines 136 and 256 still say the floor is "the cu extra in pyproject.toml". The issue listed these as optional, so the code works unchanged.
No actionable comments were generated in the recent review.
Summary
Summary by CodeRabbit
New Features
Added minimal-sysctk12 and minimal-sysctk13 installation options for using CUDA bindings with a system-installed toolkit. The cu12 and cu13 options now include the corresponding bindings version requirements alongside CUDA Toolkit wheels.
Documentation
Updated installation and support guidance on selecting compatible bindings, including for packages that depend on cuda-core, and clarified that installing cuda-core without a CUDA extra does not communicate the bindings version requirement to package installers.
Added guidance about the resolver fallback risk associated with the yanked cuda-core 1.3.0 release.
The PR moves CUDA binding version floors into minimal-sysctk12 and minimal-sysctk13 extras. The CUDA extras include those floor declarations. Floor readers, consistency checks, installation instructions, and maintainer guidance now reflect this structure.
Changes: CUDA binding floor extras
Layer / File(s)
Summary
Declare extras and resolve floors cuda_core/pyproject.toml, cuda_core/cuda/core/_bindings_floor.py, cuda_core/tests/test_bindings_floor.py
The minimal extras declare the CUDA binding floors, and cu12 and cu13 include their matching minimal extras. Floor resolution follows self-references and tests cover cycles and invalid requirements.
Update floor readers and consistency checks ci/tools/cuda_core_bindings_floor.py, ci/tools/tests/test_cuda_core_bindings_floor.py, toolshed/check_cuda_core_bindings_floor.py, cuda_core/tests/test_bindings_floor.py
The CI metadata reader and repository checker follow and validate extra references. Tests cover floor extraction and missing or invalid declarations.
Document installation and floor maintenance cuda_core/AGENTS.md, cuda_core/DESCRIPTION.rst, cuda_core/docs/source/install.rst, cuda_core/docs/source/release/1.3.1-notes.rst, cuda_core/docs/source/support.rst
The documentation describes the minimal extras, their relationship to the CUDA extras, and the floor limitations of plain cuda-core requirements.
The change moves the CUDA binding floors into new minimal-sysctk12 and minimal-sysctk13 extras. The install guidance may still let pip resolve an older cuda-core that has neither the extra nor the floor, so import fails. The release notes also claim a yank that was not visible on PyPI. Fix the guidance and confirm the yank before merging.
Security architecture risk: Minimal · up to 22349
The inspected change preserves the existing binding-version floors and major-version bounds while making them available through minimal installation extras. No introduced or worsened security, failure-containment, rollback, or ownership risk was established.
Retained concerns
No architecture-level concerns identified.
Security review details
Security Blast Radius
inferred — The supported exposure is dependency selection for consumers requesting these extras and floor interpretation during project validation or CI wheel inspection. The inspected self-reference traversal remains within the supplied configuration or metadata rather than fetching or executing referenced requirements.
Trust Boundaries and Controls
observed — The project reader still rejects missing or duplicate versioned binding requirements, malformed floor constraints, and mismatched CUDA-major bounds. The consistency hook additionally requires each cu extra to name its matching minimal extra.
Resilience and Maintainability Implications
observed — Both recursive readers track visited extras along each traversal path, preventing cycles from recursing indefinitely. Their traversal state is local to the invocation; the inspected expansion logic does not update shared persistent state.
- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts
Reviewing files that changed from the base of the PR and between c41e079 and 223499a.
Files selected for processing: 4
ci/tools/cuda_core_bindings_floor.py
cuda_core/cuda/core/_bindings_floor.py
cuda_core/docs/source/release/1.3.1-notes.rst
cuda_core/tests/test_bindings_floor.py
Files skipped from review as they are similar to previous changes: 1
cuda_core/docs/source/release/1.3.1-notes.rst
Included review availability: This review used your included allowance. Your plan provides up to 12 included reviews per hour; 11 remain after this review.
suggestion: Remove the loud-validation-failure test.
This case checks that malformed metadata raises SystemExit. It does not cover a silently incorrect floor. Remove this case and retain the successful floor-extraction coverage.
As per coding guidelines, “Keep a test only when wrong behavior would be silent.”
Reviewing files that changed from the base of the PR and between 7de298b and c41e079.
Files selected for processing: 11
ci/tools/cuda_core_bindings_floor.py
ci/tools/tests/test_cuda_core_bindings_floor.py
cuda_core/AGENTS.md
cuda_core/DESCRIPTION.rst
cuda_core/cuda/core/_bindings_floor.py
cuda_core/docs/source/install.rst
cuda_core/docs/source/release/1.3.1-notes.rst
cuda_core/docs/source/support.rst
cuda_core/pyproject.toml
cuda_core/tests/test_bindings_floor.py
toolshed/check_cuda_core_bindings_floor.py
Included review availability: This review used your included allowance. Your plan provides up to 12 included reviews per hour; 10 remain after this review.
The reason will be displayed to describe this comment to others. Learn more.
Major · Data Integrity & Integration · Quick win
important: Require a version that provides the minimal extras.
With cuda-bindings==12.9.3, pip can select cuda-core 1.3.0 instead of 1.3.1. That release lacks minimal-sysctk12, so pip warns but installs it without the floor; import then fails. (raw.githubusercontent.com)
Recommend cuda-core[minimal-sysctk12]>=1.3.1 and the equivalent CUDA 13 requirement.
The reason will be displayed to describe this comment to others. Learn more.
Minor · Functional Correctness · Quick win
important: Confirm the yank before publishing this statement.
As of November 17, 2026, PyPI lists 1.3.0 without a yank notice. (pypi.org) Readers could assume resolvers will avoid that release. Yank it before publishing these notes, or update the statement.
The reason will be displayed to describe this comment to others. Learn more.
Minor · Functional Correctness · Quick win
important: Detect missing CUDA extras independently of parsed floors.
If cu13 is deleted while cu12 and both minimal extras remain, read_floors() returns only major 12. This loop never checks cu13, so check() can pass despite the missing CUDA 13 extra.
Derive the expected majors from the minimal extras, then validate each matching cu<N> extra. Add coverage through check(). The current None test injects major 13 directly and misses this failure.
Preview will be ready when the GitHub Pages deployment is complete.
This branch has not been deployed
No deployments
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
CI/CDCI/CD infrastructurecuda.coreEverything related to the cuda.core modulepackagingAnything related to wheels or Conda packagesto-be-backportedTrigger the bot to raise a backport PR upon merge
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Part of #3459.
Moves the
cuda-bindingsfloors from thecu12/cu13extras into newminimal-sysctk12/minimal-sysctk13extras, whichcu12/cu13include by self-reference. A package that depends oncuda-core[minimal-sysctk12](or[cu12]) now passes the floor to pip and uv.The floor readers (
floors_from_extrasand the CI wheel-floor reader) still read the floor of eachcu<N>extra; they now follow acuda-core[...]self-reference and skip an unversionedcuda-bindings[all]. The existing tests of thecu<N>form are unchanged, and new tests cover the self-reference.Two additions beyond the issue:
check-cuda-core-bindings-floorhook also checks that eachcu<N>extra listscuda-core[minimal-sysctk<N>], so the floor is written only inminimal-sysctk<N>.[tool.uv].conflictsdeclares the new extras as conflicting across majors; without ituv lockfails.A CUDA 12 wheel built from this branch carries the floors under
extra == "minimal-sysctk12"/"minimal-sysctk13", andpip install --dry-run "cuda-core[cu12] @ <wheel>" cuda-bindings==12.9.3(likewise[minimal-sysctk12]) is now rejected at resolve time instead of failing at import.Checklist
-- Leo's bot