Merge branch 'main' into fix/system-event-missing-cdef-attrs

Author: rluo8

LICENSE

@@ -176,3 +176,28 @@ Copyright (c) 2024-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -52,3 +52,14 @@ The list of available interfaces is:
 
 CUDA Python is licensed under the [Apache License 2.0](./LICENSE). Third-party
 attributions for `cuda.core` are listed in [`cuda_core/NOTICE`](./cuda_core/NOTICE).
+
+Each subproject is distributed as its own package and ships a copy of the same
+license alongside its sources, so that the license accompanies the built wheel.
+The root `LICENSE` governs the repository as a whole:
+
+| Subproject       | License    | License file                                             |
+| ---------------- | ---------- | -------------------------------------------------------- |
+| `cuda.bindings`  | Apache-2.0 | [`cuda_bindings/LICENSE`](./cuda_bindings/LICENSE)       |
+| `cuda.core`      | Apache-2.0 | [`cuda_core/LICENSE`](./cuda_core/LICENSE)               |
+| `cuda.pathfinder`| Apache-2.0 | [`cuda_pathfinder/LICENSE`](./cuda_pathfinder/LICENSE)   |
+| `cuda-python`    | Apache-2.0 | [`cuda_python/LICENSE`](./cuda_python/LICENSE)           |

ci/tools/check_release_notes.py

@@ -18,6 +18,7 @@
 import os
 import re
 import sys
+from pathlib import Path
 
 COMPONENT_TO_PACKAGE: dict[str, str] = {
     "cuda-core": "cuda_core",
@@ -62,8 +63,8 @@ def is_post_release(version: str) -> bool:
     return ".post" in version
 
 
-def load_backport_branch(repo_root: str = ".") -> str | None:
-    path = os.path.join(repo_root, "ci", "versions.yml")
+def load_backport_branch(repo_root: Path = Path(".")) -> str | None:
+    path = repo_root / "ci" / "versions.yml"
     try:
         with open(path, encoding="utf-8") as f:
             for line in f:
@@ -84,13 +85,16 @@ def is_backport_version(version: str, backport_branch: str) -> bool:
     return version == backport_branch
 
 
-def notes_path(package: str, version: str) -> str:
-    return os.path.join(package, "docs", "source", "release", f"{version}-notes.rst")
+def notes_path(package: str, version: str) -> Path:
+    return Path(package, "docs", "source", "release", f"{version}-notes.rst")
 
 
-def check_release_notes(git_tag: str, component: str, repo_root: str = ".") -> list[tuple[str, str]]:
+def check_release_notes(git_tag: str, component: str, repo_root: Path = Path(".")) -> list[tuple[str | Path, str]]:
     """Return a list of (path, reason) for missing or empty release notes.
 
+    ``path`` is the repo-relative notes path, or a ``<placeholder>`` naming the
+    offending argument when the tag or component itself is the problem.
+
     Returns an empty list when notes are present and non-empty, or when the
     tag is a .post release (no new notes required).
     """
@@ -105,10 +109,10 @@ def check_release_notes(git_tag: str, component: str, repo_root: str = ".") -> l
         return []
 
     path = notes_path(COMPONENT_TO_PACKAGE[component], version)
-    full = os.path.join(repo_root, path)
-    if not os.path.isfile(full):
+    full = repo_root / path
+    if not full.is_file():
         return [(path, "missing")]
-    if os.path.getsize(full) == 0:
+    if full.stat().st_size == 0:
         return [(path, "empty")]
     return []
 
@@ -123,7 +127,7 @@ def write_step_summary(message: str) -> None:
             f.write("\n")
 
 
-def warn_missing_backport_notes(git_tag: str, component: str, problems: list[tuple[str, str]]) -> None:
+def warn_missing_backport_notes(git_tag: str, component: str, problems: list[tuple[str | Path, str]]) -> None:
     print(f"WARNING: missing or empty release notes for backport tag {git_tag}:")
     summary_lines = [
         "## Release Notes Reminder",
@@ -147,8 +151,8 @@ def validate_backport_decision(
     version: str,
     backport_git_tag: str,
     backport_branch: str | None,
-    repo_root: str,
-) -> tuple[int | None, list[tuple[str, str]]]:
+    repo_root: Path,
+) -> tuple[int | None, list[tuple[str | Path, str]]]:
     if component not in BACKPORT_PLANNING_COMPONENTS or is_post_release(version):
         return None, []
 
@@ -205,7 +209,7 @@ def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(description=__doc__)
     parser.add_argument("--git-tag", required=True)
     parser.add_argument("--component", required=True, choices=list(COMPONENT_TO_PACKAGE))
-    parser.add_argument("--repo-root", default=".")
+    parser.add_argument("--repo-root", default=Path("."), type=Path)
     parser.add_argument("--backport-git-tag", default="")
     parser.add_argument("--backport-branch", default="")
     args = parser.parse_args(argv)

ci/tools/tests/test_check_release_notes.py

@@ -3,10 +3,10 @@
 
 from __future__ import annotations
 
-import os
 import sys
+from pathlib import Path
 
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+sys.path.insert(0, str(Path(__file__).parent.parent))
 from check_release_notes import (
     check_release_notes,
     is_post_release,
@@ -87,43 +87,43 @@ def _make_notes(self, tmp_path, pkg, version, content="Release notes."):
 
     def test_present_and_nonempty(self, tmp_path):
         self._make_notes(tmp_path, "cuda_core", "0.7.0")
-        problems = check_release_notes("cuda-core-v0.7.0", "cuda-core", str(tmp_path))
+        problems = check_release_notes("cuda-core-v0.7.0", "cuda-core", tmp_path)
         assert problems == []
 
     def test_missing(self, tmp_path):
-        problems = check_release_notes("cuda-core-v0.7.0", "cuda-core", str(tmp_path))
+        problems = check_release_notes("cuda-core-v0.7.0", "cuda-core", tmp_path)
         assert len(problems) == 1
         assert problems[0][1] == "missing"
 
     def test_empty(self, tmp_path):
         self._make_notes(tmp_path, "cuda_core", "0.7.0", content="")
-        problems = check_release_notes("cuda-core-v0.7.0", "cuda-core", str(tmp_path))
+        problems = check_release_notes("cuda-core-v0.7.0", "cuda-core", tmp_path)
         assert len(problems) == 1
         assert problems[0][1] == "empty"
 
     def test_post_release_skipped(self, tmp_path):
-        problems = check_release_notes("v12.6.2.post1", "cuda-bindings", str(tmp_path))
+        problems = check_release_notes("v12.6.2.post1", "cuda-bindings", tmp_path)
         assert problems == []
 
     def test_invalid_tag(self, tmp_path):
-        problems = check_release_notes("not-a-tag", "cuda-core", str(tmp_path))
+        problems = check_release_notes("not-a-tag", "cuda-core", tmp_path)
         assert len(problems) == 1
         assert "cannot parse" in problems[0][1]
 
     def test_component_prefix_mismatch(self, tmp_path):
         # Pass a cuda-core tag with component=cuda-pathfinder; must be rejected.
-        problems = check_release_notes("cuda-core-v0.7.0", "cuda-pathfinder", str(tmp_path))
+        problems = check_release_notes("cuda-core-v0.7.0", "cuda-pathfinder", tmp_path)
         assert len(problems) == 1
         assert "cannot parse" in problems[0][1]
 
     def test_unknown_component(self, tmp_path):
-        problems = check_release_notes("v13.1.0", "bogus", str(tmp_path))
+        problems = check_release_notes("v13.1.0", "bogus", tmp_path)
         assert len(problems) == 1
         assert "unknown component" in problems[0][1]
 
     def test_plain_v_tag(self, tmp_path):
         self._make_notes(tmp_path, "cuda_python", "13.1.0")
-        problems = check_release_notes("v13.1.0", "cuda-python", str(tmp_path))
+        problems = check_release_notes("v13.1.0", "cuda-python", tmp_path)
         assert problems == []
 
 
@@ -133,17 +133,17 @@ def test_from_versions_yml(self, tmp_path):
         d.mkdir(parents=True)
         (d / "versions.yml").write_text('backport_branch: "12.9.x"\n')
 
-        assert load_backport_branch(str(tmp_path)) == "12.9.x"
+        assert load_backport_branch(tmp_path) == "12.9.x"
 
     def test_from_github_ref_name_for_legacy_backport_branch(self, tmp_path, monkeypatch):
         monkeypatch.setenv("GITHUB_REF_NAME", "12.9.x")
 
-        assert load_backport_branch(str(tmp_path)) == "12.9.x"
+        assert load_backport_branch(tmp_path) == "12.9.x"
 
     def test_ignores_non_backport_github_ref_name(self, tmp_path, monkeypatch):
         monkeypatch.setenv("GITHUB_REF_NAME", "main")
 
-        assert load_backport_branch(str(tmp_path)) is None
+        assert load_backport_branch(tmp_path) is None
 
 
 class TestMain:

cuda_bindings/LICENSE

@@ -176,3 +176,28 @@ Copyright (c) 2024-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

cuda_bindings/examples/0_Introduction/clock_nvrtc.py

@@ -1,4 +1,4 @@
-# Copyright 2021-2026 NVIDIA Corporation.  All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 # ################################################################################

cuda_bindings/examples/0_Introduction/simple_cubemap_texture.py

@@ -1,4 +1,4 @@
-# Copyright 2021-2026 NVIDIA Corporation.  All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 # ################################################################################

cuda_bindings/examples/0_Introduction/simple_p2p.py

@@ -1,4 +1,4 @@
-# Copyright 2021-2026 NVIDIA Corporation.  All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 # ################################################################################

cuda_bindings/examples/0_Introduction/simple_zero_copy.py

@@ -1,4 +1,4 @@
-# Copyright 2021-2026 NVIDIA Corporation.  All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 # ################################################################################

cuda_bindings/examples/0_Introduction/system_wide_atomics.py

@@ -1,4 +1,4 @@
-# Copyright 2021-2026 NVIDIA Corporation.  All rights reserved.
+# SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
 # ################################################################################