bpo-36373: Deprecate explicit loop in task and subprocess API (GH-16033)
diff --git a/Doc/library/asyncio-subprocess.rst b/Doc/library/asyncio-subprocess.rst
index 444fb63..bd92257 100644
--- a/Doc/library/asyncio-subprocess.rst
+++ b/Doc/library/asyncio-subprocess.rst
@@ -71,6 +71,10 @@
See the documentation of :meth:`loop.subprocess_exec` for other
parameters.
+ .. deprecated-removed:: 3.8 3.10
+
+ The *loop* parameter.
+
.. coroutinefunction:: create_subprocess_shell(cmd, stdin=None, \
stdout=None, stderr=None, loop=None, \
limit=None, \*\*kwds)
@@ -95,6 +99,10 @@
escape whitespace and special shell characters in strings that are going
to be used to construct shell commands.
+ .. deprecated-removed:: 3.8 3.10
+
+ The *loop* parameter.
+
.. note::
The default asyncio event loop implementation on **Windows** does not
diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index 1fcdcb9..57e0e07 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -334,6 +334,9 @@
cancellation of one submitted Task/Future to cause other
Tasks/Futures to be cancelled.
+ .. deprecated-removed:: 3.8 3.10
+ The *loop* parameter.
+
.. _asyncio_example_gather:
Example::
@@ -411,6 +414,9 @@
except CancelledError:
res = None
+ .. deprecated-removed:: 3.8 3.10
+ The *loop* parameter.
+
Timeouts
========
@@ -478,22 +484,12 @@
set concurrently and block until the condition specified
by *return_when*.
- .. deprecated:: 3.8
-
- If any awaitable in *aws* is a coroutine, it is automatically
- scheduled as a Task. Passing coroutines objects to
- ``wait()`` directly is deprecated as it leads to
- :ref:`confusing behavior <asyncio_example_wait_coroutine>`.
-
Returns two sets of Tasks/Futures: ``(done, pending)``.
Usage::
done, pending = await asyncio.wait(aws)
- .. deprecated-removed:: 3.8 3.10
- The *loop* parameter.
-
*timeout* (a float or int), if specified, can be used to control
the maximum number of seconds to wait before returning.
@@ -525,6 +521,17 @@
Unlike :func:`~asyncio.wait_for`, ``wait()`` does not cancel the
futures when a timeout occurs.
+ .. deprecated:: 3.8
+
+ If any awaitable in *aws* is a coroutine, it is automatically
+ scheduled as a Task. Passing coroutines objects to
+ ``wait()`` directly is deprecated as it leads to
+ :ref:`confusing behavior <asyncio_example_wait_coroutine>`.
+
+ .. deprecated-removed:: 3.8 3.10
+
+ The *loop* parameter.
+
.. _asyncio_example_wait_coroutine:
.. note::
@@ -568,6 +575,9 @@
Raises :exc:`asyncio.TimeoutError` if the timeout occurs before
all Futures are done.
+ .. deprecated-removed:: 3.8 3.10
+ The *loop* parameter.
+
Example::
for f in as_completed(aws):
@@ -694,6 +704,9 @@
.. versionchanged:: 3.8
Added the ``name`` parameter.
+ .. deprecated-removed:: 3.8 3.10
+ The *loop* parameter.
+
.. method:: cancel()
Request the Task to be cancelled.