gh-85747: "Preface" section of asyncio-eventloop.rst: Switch to active voice and suggest other edits (#99784)

This commit is contained in:
Brian Skinn 2022-12-03 19:48:41 -05:00 committed by GitHub
parent a87c46eab3
commit bf26bdf6ac
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -33,7 +33,8 @@ an event loop:
Return the running event loop in the current OS thread. Return the running event loop in the current OS thread.
If there is no running event loop a :exc:`RuntimeError` is raised. Raise a :exc:`RuntimeError` if there is no running event loop.
This function can only be called from a coroutine or a callback. This function can only be called from a coroutine or a callback.
.. versionadded:: 3.7 .. versionadded:: 3.7
@ -52,17 +53,19 @@ an event loop:
:func:`get_running_loop` function is preferred to :func:`get_event_loop` :func:`get_running_loop` function is preferred to :func:`get_event_loop`
in coroutines and callbacks. in coroutines and callbacks.
Consider also using the :func:`asyncio.run` function instead of using As noted above, consider using the higher-level :func:`asyncio.run` function,
lower level functions to manually create and close an event loop. instead of using these lower level functions to manually create and close an
event loop.
.. deprecated:: 3.10 .. deprecated:: 3.10
Deprecation warning is emitted if there is no running event loop. Emits a deprecation warning if there is no running event loop.
In future Python releases, this function will be an alias of In future Python releases, this function may become an alias of
:func:`get_running_loop`. :func:`get_running_loop` and will accordingly raise a
:exc:`RuntimeError` if there is no running event loop.
.. function:: set_event_loop(loop) .. function:: set_event_loop(loop)
Set *loop* as a current event loop for the current OS thread. Set *loop* as the current event loop for the current OS thread.
.. function:: new_event_loop() .. function:: new_event_loop()