[Compat] Remove device parameter from Event class and update documentation (PaddlePaddle#76379)

Author: fxyfxy777

python/paddle/device/__init__.py

@@ -1018,27 +1018,46 @@ class Event:
     A device event wrapper around StreamBase.
 
     Args:
-        device(str|paddle.CUDAPlace(n)|paddle.CustomPlace(n)|None): Which device the stream run on. If device is None, the device is the current device. Default: None.
-            It can be ``gpu``, ``gpu:x``, ``custom_device``, ``custom_device:x``, where ``custom_device`` is the name of CustomDevice,
-            where ``x`` is the index of the GPUs, XPUs. And it can be paddle.CUDAPlace(n) or paddle.CustomPlace(n).
         enable_timing (bool, optional): indicates if the event should measure time, default is False
         blocking (bool, optional): if True, ``wait`` will be blocking, default is False
         interprocess (bool): if True, the event can be shared between processes, default is False
 
     Returns:
         Event: The event.
 
+    Note:
+        The `device` parameter has been removed in the latest version. The event will always use the current device context.
+        Previously, you could specify the device like:
+        ```python
+        # Old usage (no longer supported)
+        e = paddle.device.Event(device="gpu:0")
+        ```
+        Now it will automatically use the current device:
+        ```python
+        # New usage
+        paddle.set_device("gpu:0")  # Set device first
+        e = paddle.device.Event()   # Will use gpu:0
+        ```
+
+        paddle.device.Event is equivalent to paddle.cuda.Event.
+
     Examples:
         .. code-block:: python
 
             >>> # doctest: +REQUIRES(env:CUSTOM_DEVICE)
             >>> import paddle
 
             >>> paddle.set_device('custom_cpu')
-            >>> e1 = paddle.device.Event()
-            >>> e2 = paddle.device.Event('custom_cpu')
-            >>> e3 = paddle.device.Event('custom_cpu:0')
-            >>> e4 = paddle.device.Event(paddle.CustomPlace('custom_cpu', 0))
+            >>> e1 = paddle.device.Event()  # Uses current device (custom_cpu)
+            >>>
+            >>> # Old usage (no longer supported):
+            >>> # e2 = paddle.device.Event('custom_cpu')
+            >>> # e3 = paddle.device.Event('custom_cpu:0')
+            >>> # e4 = paddle.device.Event(paddle.CustomPlace('custom_cpu', 0))
+            >>>
+            >>> # New equivalent usage:
+            >>> paddle.set_device('custom_cpu:0')
+            >>> e5 = paddle.device.Event()  # Uses custom_cpu:0
 
     '''
 
@@ -1048,17 +1067,11 @@ class Event:
 
     def __init__(
         self,
-        device: PlaceLike | None = None,
         enable_timing: bool = False,
         blocking: bool = False,
         interprocess: bool = False,
     ) -> None:
-        if device is None:
-            self.device = paddle.framework._current_expected_place_()
-        elif isinstance(device, str):
-            self.device = paddle.device._convert_to_place(device)
-        else:
-            self.device = device
+        self.device = paddle.framework._current_expected_place_()
 
         device_id = (
             self.device.get_device_id()
@@ -1340,7 +1353,7 @@ def record_event(self, event: Event | None = None) -> Event:
 
         '''
         if event is None:
-            event = Event(self.device)
+            event = Event()
         event.record(self)
         return event
 

test/compat/test_event_stream_apis.py

@@ -90,12 +90,10 @@ def _test_event_stream_apis_impl(self, device_str):
         event1 = paddle.device.Event()
         self.assertIsInstance(event1, paddle.device.Event)
 
-        event2 = paddle.device.Event(device=device_str, enable_timing=True)
+        event2 = paddle.device.Event(enable_timing=True)
         self.assertIsInstance(event2, paddle.device.Event)
 
-        event3 = paddle.device.Event(
-            device=device_str, enable_timing=True, blocking=True
-        )
+        event3 = paddle.device.Event(enable_timing=True, blocking=True)
         self.assertIsInstance(event3, paddle.device.Event)
 
         # Test Stream creation with different parameters
@@ -159,12 +157,8 @@ def _test_event_stream_apis_impl(self, device_str):
         # Test Event.elapsed_time()
         if hasattr(event1, 'event_base') and hasattr(event2, 'event_base'):
             # Create events with timing enabled
-            start_event = paddle.device.Event(
-                device=device_str, enable_timing=True
-            )
-            end_event = paddle.device.Event(
-                device=device_str, enable_timing=True
-            )
+            start_event = paddle.device.Event(enable_timing=True)
+            end_event = paddle.device.Event(enable_timing=True)
 
             # Record start event
             start_event.record()
@@ -243,7 +237,7 @@ def _test_event_stream_apis_impl(self, device_str):
     def test_event_stream_error_handling(self):
         """Test Event and Stream error handling."""
         # Test with invalid device types
-        with self.assertRaises(ValueError):
+        with self.assertRaises(TypeError):
             paddle.device.Event(device='invalid_device:0')
 
         with self.assertRaises(ValueError):
@@ -258,8 +252,8 @@ def test_event_stream_error_handling(self):
             )
             paddle.device.set_device(device_str)
 
-            event1 = paddle.device.Event(device=device_str)
-            event2 = paddle.device.Event(device=device_str)
+            event1 = paddle.device.Event()
+            event2 = paddle.device.Event()
 
             # Should not raise exception even if events are not recorded
             try:
@@ -320,8 +314,8 @@ def test_event_stream_timing_functionality(self):
         paddle.device.set_device(device_str)
 
         # Create events with timing enabled
-        start_event = paddle.device.Event(device=device_str, enable_timing=True)
-        end_event = paddle.device.Event(device=device_str, enable_timing=True)
+        start_event = paddle.device.Event(enable_timing=True)
+        end_event = paddle.device.Event(enable_timing=True)
 
         # Create a stream for work execution
         stream = paddle.device.Stream(device=device_str)