cuda.core.system: Add APIs related to events

[mdboom]

Prerequsite: #1446

Description

• New or existing tests cover these changes.
• The documentation is up to date with these changes.

[copy-pr-bot]

Auto-sync is disabled for ready for review pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

[Copilot]

Pull request overview

This pull request adds event-related APIs to the cuda.core.system module, enabling applications to register and wait for hardware events from CUDA devices. The implementation provides a high-level Python interface over NVML's event system.

Key changes include:

• Addition of EventType, EventData, and DeviceEvents classes for event handling
• New Device.register_events() and Device.get_supported_event_types() methods
• Refactored system event handling in NVML bindings with proper versioned API usage
• Array size fixes in NumPy dtype definitions for proper struct array handling

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
cuda_core/tests/system/test_system_device.py	Adds test coverage for event registration and timeout behavior
cuda_core/docs/source/api.rst	Documents new public API classes: DeviceEvents, EventData, EventType
cuda_core/cuda/core/system/_device_utils.pxi	Removes unused import and cleans up internal documentation
cuda_core/cuda/core/system/_device.pyx	Implements EventType, EventData, and DeviceEvents classes with device event APIs
cuda_bindings/cuda/bindings/_nvml.pyx	Refactors system event functions to use versioned structs and fixes array dtype definitions
cuda_bindings/cuda/bindings/_nvml.pxd	Removes old system event declarations and typedef

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[copy-pr-bot]

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

[mdboom]

/ok to test

[github-actions]

Doc Preview CI
🚀 View preview at https://nvidia.github.io/cuda-python/pr-preview/pr-1448/
https://nvidia.github.io/cuda-python/pr-preview/pr-1448/cuda-core/
https://nvidia.github.io/cuda-python/pr-preview/pr-1448/cuda-bindings/
https://nvidia.github.io/cuda-python/pr-preview/pr-1448/cuda-pathfinder/
Preview will be ready when the GitHub Pages deployment is complete.

[mdboom]

/ok to test