Skip to content

cuda.core v0.5.0 doc final pass #1401

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
leofang merged 4 commits into from
Dec 17, 2025
Merged

cuda.core v0.5.0 doc final pass #1401

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
14700c9
fix warnings and hyperlinks
leofang Dec 17, 2025
962a88b
mention experimental namespace
leofang Dec 17, 2025
8cdac2e
remove win32 from VirtualMemoryHandleTypeT
leofang Dec 17, 2025
c36c2d8
fix typo
leofang Dec 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions cuda_core/cuda/core/_memory/_virtual_memory_resource.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@

__all__ = ["VirtualMemoryResourceOptions", "VirtualMemoryResource"]

VirtualMemoryHandleTypeT = Union[Literal["posix_fd", "generic", "win32", "win32_kmt", "fabric"], None]
VirtualMemoryHandleTypeT = Union[Literal["posix_fd", "generic", "win32_kmt", "fabric"], None]
VirtualMemoryLocationTypeT = Literal["device", "host", "host_numa", "host_numa_current"]
VirtualMemoryGranularityT = Literal["minimum", "recommended"]
VirtualMemoryAccessTypeT = Union[Literal["rw", "r"], None]
Expand Down Expand Up @@ -81,7 +81,6 @@ class VirtualMemoryResourceOptions:
_handle_types = {
None: _h.CU_MEM_HANDLE_TYPE_NONE,
"posix_fd": _h.CU_MEM_HANDLE_TYPE_POSIX_FILE_DESCRIPTOR,
"win32": _h.CU_MEM_HANDLE_TYPE_WIN32,
"win32_kmt": _h.CU_MEM_HANDLE_TYPE_WIN32_KMT,
"fabric": _h.CU_MEM_HANDLE_TYPE_FABRIC,
}
Expand Down
17 changes: 8 additions & 9 deletions cuda_core/docs/source/api_private.rst
View file
Open in desktop
Copy link
Member Author

@leofang leofang Dec 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: This fixes most of the warnings seen in recent doc build CI runs. The warnings are cleared out now:
https://github.com/NVIDIA/cuda-python/actions/runs/20316169131/job/58361045100?pr=1401#step:20:1187
Though, to my surprise, we still have 3 instead of 0 warnings. We can look into it after the release (or the holidays...)

Original file line number Diff line number Diff line change
Expand Up @@ -16,16 +16,15 @@ CUDA runtime
.. autosummary::
:toctree: generated/

_memory.PyCapsule
_memory.DevicePointerT
_memory.VirtualMemoryAllocationTypeT
_memory.VirtualMemoryLocationTypeT
_memory.VirtualMemoryGranularityT
_memory.VirtualMemoryAccessTypeT
_memory.VirtualMemoryHandleTypeT
_memory._buffer.DevicePointerT
_memory._virtual_memory_resource.VirtualMemoryAllocationTypeT
_memory._virtual_memory_resource.VirtualMemoryLocationTypeT
_memory._virtual_memory_resource.VirtualMemoryGranularityT
_memory._virtual_memory_resource.VirtualMemoryAccessTypeT
_memory._virtual_memory_resource.VirtualMemoryHandleTypeT
_device.DeviceProperties
_memory.IPCAllocationHandle
_memory.IPCBufferDescriptor
_memory._ipc.IPCAllocationHandle
_memory._ipc.IPCBufferDescriptor
_module.KernelAttributes
_module.KernelOccupancy
_module.ParamInfo
Expand Down
2 changes: 2 additions & 0 deletions cuda_core/docs/source/release/0.5.0-notes.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@ Breaking Changes

The support for setting :attr:`VirtualMemoryResourceOptions.handle_type` to ``"win32"`` is removed. Please reach out to us on GitHub if you have a use case.

All public APIs accessible under the ``cuda.core.experimental`` namespace are now moved to the top-level ``cuda.core`` namespace. For example, ``cuda.core.experimental.Device`` is now accessible as :class:`cuda.core.Device`. The ``cuda.core.experimental`` namespace is still retained for backward compatibility, but is considered deprecated and will be removed by ``cuda.core`` v1.0.0.

The following APIs have been deprecated and will be removed in 0.6.0:

- ``cuda.core.experimental.system.driver_version`` has been replaced with
Expand Down