the name of the task using :meth:`Task.set_name`.
.. versionchanged:: 3.8
- Added the ``name`` parameter.
+ Added the *name* parameter.
.. method:: loop.set_task_factory(factory)
to wait for the TLS handshake to complete before aborting the connection.
``60.0`` seconds if ``None`` (default).
- .. versionadded:: 3.8
+ .. versionchanged:: 3.5
+
+ Added support for SSL/TLS in :class:`ProactorEventLoop`.
+
+ .. versionchanged:: 3.6
+
+ The socket option :py:data:`~socket.TCP_NODELAY` is set by default
+ for all TCP connections.
+
+ .. versionchanged:: 3.7
+
+ Added the *ssl_handshake_timeout* parameter.
+
+ .. versionchanged:: 3.8
Added the *happy_eyeballs_delay* and *interleave* parameters.
For more information: https://tools.ietf.org/html/rfc6555
- .. versionadded:: 3.7
-
- The *ssl_handshake_timeout* parameter.
-
- .. versionchanged:: 3.6
-
- The socket option :py:data:`~socket.TCP_NODELAY` is set by default
- for all TCP connections.
-
- .. versionchanged:: 3.5
-
- Added support for SSL/TLS in :class:`ProactorEventLoop`.
-
.. seealso::
The :func:`open_connection` function is a high-level alternative
.. availability:: Unix.
- .. versionadded:: 3.7
-
- The *ssl_handshake_timeout* parameter.
-
.. versionchanged:: 3.7
-
+ Added the *ssl_handshake_timeout* parameter.
The *path* parameter can now be a :term:`path-like object`.
:meth:`Server.serve_forever` to make the server to start accepting
connections.
- .. versionadded:: 3.7
-
- Added *ssl_handshake_timeout* and *start_serving* parameters.
-
- .. versionchanged:: 3.6
-
- The socket option :py:data:`~socket.TCP_NODELAY` is set by default
- for all TCP connections.
-
.. versionchanged:: 3.5
Added support for SSL/TLS in :class:`ProactorEventLoop`.
The *host* parameter can be a sequence of strings.
+ .. versionchanged:: 3.6
+
+ Added *ssl_handshake_timeout* and *start_serving* parameters.
+ The socket option :py:data:`~socket.TCP_NODELAY` is set by default
+ for all TCP connections.
+
.. seealso::
The :func:`start_server` function is a higher-level alternative API
.. availability:: Unix.
- .. versionadded:: 3.7
-
- The *ssl_handshake_timeout* and *start_serving* parameters.
-
.. versionchanged:: 3.7
+ Added the *ssl_handshake_timeout* and *start_serving* parameters.
The *path* parameter can now be a :class:`~pathlib.Path` object.
.. coroutinemethod:: loop.connect_accepted_socket(protocol_factory, \
Returns a ``(transport, protocol)`` pair.
- .. versionadded:: 3.7
+ .. versionadded:: 3.5.3
- The *ssl_handshake_timeout* parameter.
+ .. versionchanged:: 3.7
- .. versionadded:: 3.5.3
+ Added the *ssl_handshake_timeout* parameter.
Transferring files
schedule the callbacks, and return ``True``.
.. versionchanged:: 3.9
- Added the ``msg`` parameter.
+ Added the *msg* parameter.
.. method:: exception()
the queue is always known and can be returned by calling the
:meth:`qsize` method.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
+
This class is :ref:`not thread safe <asyncio-multithreading>`.
Raises :exc:`ValueError` if called more times than there were
items placed in the queue.
- .. deprecated-removed:: 3.8 3.10
-
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
-
Priority Queue
==============
The rest of the arguments are passed directly to
:meth:`loop.create_connection`.
- .. versionadded:: 3.7
-
- The *ssl_handshake_timeout* parameter.
-
- .. deprecated-removed:: 3.8 3.10
+ .. versionchanged:: 3.7
+ Added the *ssl_handshake_timeout* parameter.
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. coroutinefunction:: start_server(client_connected_cb, host=None, \
The rest of the arguments are passed directly to
:meth:`loop.create_server`.
- .. versionadded:: 3.7
-
- The *ssl_handshake_timeout* and *start_serving* parameters.
-
- .. deprecated-removed:: 3.8 3.10
+ .. versionchanged:: 3.7
+ Added the *ssl_handshake_timeout* and *start_serving* parameters.
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. rubric:: Unix Sockets
.. availability:: Unix.
- .. versionadded:: 3.7
-
- The *ssl_handshake_timeout* parameter.
-
.. versionchanged:: 3.7
-
+ Added the *ssl_handshake_timeout* parameter.
The *path* parameter can now be a :term:`path-like object`
- .. deprecated-removed:: 3.8 3.10
-
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. coroutinefunction:: start_unix_server(client_connected_cb, path=None, \
.. availability:: Unix.
- .. versionadded:: 3.7
-
- The *ssl_handshake_timeout* and *start_serving* parameters.
-
.. versionchanged:: 3.7
-
+ Added the *ssl_handshake_timeout* and *start_serving* parameters.
The *path* parameter can now be a :term:`path-like object`.
- .. deprecated-removed:: 3.8 3.10
-
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
StreamReader
See the documentation of :meth:`loop.subprocess_exec` for other
parameters.
- .. deprecated-removed:: 3.8 3.10
-
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. coroutinefunction:: create_subprocess_shell(cmd, stdin=None, \
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. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. note::
finally:
lock.release()
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This class has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. coroutinemethod:: acquire()
:meth:`clear` method. The :meth:`~Event.wait` method blocks until the
flag is set to *true*. The flag is set to *false* initially.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This class has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. _asyncio_example_sync_event:
``None``. In the latter case a new Lock object is created
automatically.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This class has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
The preferred way to use a Condition is an :keyword:`async with`
statement::
internal counter (``1`` by default). If the given value is
less than ``0`` a :exc:`ValueError` is raised.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This class has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
The preferred way to use a Semaphore is an :keyword:`async with`
statement::
a :exc:`ValueError` in :meth:`~Semaphore.release` if it
increases the internal counter above the initial *value*.
- .. deprecated-removed:: 3.8 3.10
-
- The ``loop`` parameter. This class has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
---------
.. versionadded:: 3.7
.. versionchanged:: 3.8
- Added the ``name`` parameter.
+ Added the *name* parameter.
Sleeping
asyncio.run(display_date())
- .. deprecated-removed:: 3.8 3.10
-
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
Running Tasks Concurrently
cancellation of one submitted Task/Future to cause other
Tasks/Futures to be cancelled.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. _asyncio_example_gather:
If the *gather* itself is cancelled, the cancellation is
propagated regardless of *return_exceptions*.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. deprecated:: 3.10
Deprecation warning is emitted if no positional arguments are provided
except CancelledError:
res = None
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. deprecated:: 3.10
Deprecation warning is emitted if *aw* is not Future-like object
If the wait is cancelled, the future *aw* is also cancelled.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. _asyncio_example_waitfor:
for *aw* to be cancelled. Previously, it raised
:exc:`TimeoutError` immediately.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
Waiting Primitives
``wait()`` directly is deprecated as it leads to
:ref:`confusing behavior <asyncio_example_wait_coroutine>`.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. _asyncio_example_wait_coroutine:
.. note::
if task in done:
# Everything will work as expected now.
- .. deprecated-removed:: 3.8 3.10
-
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
-
.. deprecated-removed:: 3.8 3.11
Passing coroutine objects to ``wait()`` directly is
deprecated.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
+
.. function:: as_completed(aws, *, timeout=None)
Raises :exc:`TimeoutError` if the timeout occurs before
all Futures are done.
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
Example::
earliest_result = await coro
# ...
- .. deprecated-removed:: 3.8 3.10
- The ``loop`` parameter. This function has been implicitly getting the
- current running loop since 3.7. See
- :ref:`What's New in 3.10's Removed section <whatsnew310-removed>`
- for more information.
+ .. versionchanged:: 3.10
+ Removed the *loop* parameter.
.. deprecated:: 3.10
Deprecation warning is emitted if not all awaitable objects in the *aws*
Added support for the :mod:`contextvars` module.
.. versionchanged:: 3.8
- Added the ``name`` parameter.
-
- .. deprecated-removed:: 3.8 3.10
- The *loop* parameter.
+ Added the *name* parameter.
.. deprecated:: 3.10
Deprecation warning is emitted if *loop* is not specified
discouraged.
.. versionchanged:: 3.9
- Added the ``msg`` parameter.
+ Added the *msg* parameter.
.. _asyncio_example_task_cancel:
projects / thirdparty / Python / cpython.git / commitdiff
