diff --git a/.github/workflows/build-and-test.yml b/.github/workflows/build-and-test.yml index ed360b3bc76..a78b799d379 100644 --- a/.github/workflows/build-and-test.yml +++ b/.github/workflows/build-and-test.yml @@ -157,10 +157,9 @@ jobs: $CHOWN -R $(whoami) ${{ env.CUDA_BINDINGS_ARTIFACTS_DIR }} ls -lahR ${{ env.CUDA_BINDINGS_ARTIFACTS_DIR }} - # TODO: enable this after NVIDIA/cuda-python#297 is resolved - # - name: Check cuda.bindings wheel - # run: | - # twine check ${{ env.CUDA_BINDINGS_ARTIFACTS_DIR }}/*.whl + - name: Check cuda.bindings wheel + run: | + twine check ${{ env.CUDA_BINDINGS_ARTIFACTS_DIR }}/*.whl - name: Upload cuda.bindings build artifacts uses: actions/upload-artifact@v4 diff --git a/README.md b/README.md index 3b7338a32fa..79200a13a7b 100644 --- a/README.md +++ b/README.md @@ -37,3 +37,9 @@ The list of available interfaces are: * CUDA Runtime * NVRTC * nvJitLink + +## Supported Python Versions + +All `cuda-python` subpackages follows CPython [End-Of-Life](https://devguide.python.org/versions/) schedule for supported Python version guarantee. + +Before dropping support there will be an issue raised as a notice. diff --git a/cuda_bindings/DESCRIPTION.rst b/cuda_bindings/DESCRIPTION.rst new file mode 100644 index 00000000000..5dd065e4deb --- /dev/null +++ b/cuda_bindings/DESCRIPTION.rst @@ -0,0 +1,26 @@ +******************************************************* +cuda.bindings: Low-level CUDA interfaces +******************************************************* + +`cuda.bindings` is a standard set of low-level interfaces, providing full coverage of and access to the CUDA host APIs from Python. Checkout the `Overview `_ for the workflow and performance results. + +Installation +============ + +`cuda.bindings` can be installed from: + +* PyPI +* Conda (conda-forge/nvidia channels) +* Source builds + +Differences between these options are described in `Installation `_ documentation. Each package guarantees minor version compatibility. + +Runtime Dependencies +==================== + +`cuda.bindings` is supported on all the same platforms as CUDA. Specific dependencies are as follows: + +* Driver: Linux (450.80.02 or later) Windows (456.38 or later) +* CUDA Toolkit 12.x + +Only the NVRTC and nvJitLink redistributable components are required from the CUDA Toolkit, which can be obtained via PyPI, Conda, or local installers (as described in the CUDA Toolkit `Windows `_ and `Linux `_ Installation Guides). diff --git a/cuda_bindings/README.md b/cuda_bindings/README.md index 3ece5667dcc..ca3b1cfd072 100644 --- a/cuda_bindings/README.md +++ b/cuda_bindings/README.md @@ -6,7 +6,7 @@ ## Installing -CUDA Python can be installed from: +`cuda.bindings` can be installed from: * PyPI * Conda (conda-forge/nvidia channels) @@ -16,23 +16,13 @@ Differences between these options are described in [Installation](https://nvidia ## Runtime Dependencies -CUDA Python is supported on all platforms that CUDA is supported. Specific dependencies are as follows: +`cuda.bindings` is supported on all the same platforms as CUDA. Specific dependencies are as follows: * Driver: Linux (450.80.02 or later) Windows (456.38 or later) * CUDA Toolkit 12.x Only the NVRTC and nvJitLink redistributable components are required from the CUDA Toolkit, which can be obtained via PyPI, Conda, 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). -### Supported Python Versions - -CUDA Python follows [NEP 29](https://numpy.org/neps/nep-0029-deprecation_policy.html) for supported Python version guarantee. - -Before dropping support, an issue will be raised to look for feedback. - -Source builds work for multiple Python versions, however pre-build PyPI and Conda packages are only provided for a subset: - -* Python 3.9 to 3.12 - ## Developing We use `pre-commit` to manage various tools to help development and ensure consistency. diff --git a/cuda_bindings/pyproject.toml b/cuda_bindings/pyproject.toml index 6357b4064b9..7965448b074 100644 --- a/cuda_bindings/pyproject.toml +++ b/cuda_bindings/pyproject.toml @@ -27,7 +27,10 @@ classifiers = [ "Programming Language :: Python :: 3.12", "Environment :: GPU :: NVIDIA CUDA", ] -dynamic = ["version"] +dynamic = [ + "version", + "readme", +] dependencies = [ "pywin32; sys_platform == 'win32'", ] @@ -47,6 +50,7 @@ include = ["cuda*"] [tool.setuptools.dynamic] version = { attr = "cuda.bindings._version.__version__" } +readme = { file = ["DESCRIPTION.rst"], content-type = "text/x-rst" } [tool.ruff] line-length = 120 diff --git a/cuda_core/README.md b/cuda_core/README.md index de68bc9e478..534cdb8fef5 100644 --- a/cuda_core/README.md +++ b/cuda_core/README.md @@ -4,7 +4,7 @@ Currently under active development; see [the documentation](https://nvidia.githu ## Installing -TO build from source, just do: +To build from source, just do: ```shell $ git clone https://github.com/NVIDIA/cuda-python $ cd cuda-python/cuda_core # move to the directory where this README locates