From f1e5d8e5f5e0b6e8601b9c94eb67037170610325 Mon Sep 17 00:00:00 2001 From: Mandeep Singh Date: Wed, 30 May 2018 00:07:08 +0530 Subject: [PATCH] bpo-30935: update get_event_loop docs (GH-2731) (cherry picked from commit e55de2d77f10d524be0b426e587fbc820f76de71) Co-authored-by: Mandeep Singh --- Doc/library/asyncio-eventloops.rst | 5 ++++- Doc/whatsnew/3.6.rst | 2 +- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/Doc/library/asyncio-eventloops.rst b/Doc/library/asyncio-eventloops.rst index 7970e9039dfd86..3aa9ffeff268c4 100644 --- a/Doc/library/asyncio-eventloops.rst +++ b/Doc/library/asyncio-eventloops.rst @@ -169,12 +169,15 @@ An event loop policy must implement the following interface: Get the event loop for the current context. Returns an event loop object implementing the :class:`AbstractEventLoop` - interface. + interface. In case called from coroutine, it returns the currently + running event loop. Raises an exception in case no event loop has been set for the current context and the current policy does not specify to create one. It must never return ``None``. + .. versionchanged:: 3.6 + .. method:: set_event_loop(loop) Set the event loop for the current context to *loop*. diff --git a/Doc/whatsnew/3.6.rst b/Doc/whatsnew/3.6.rst index 88146dc7bcb85d..c5ccd85603c031 100644 --- a/Doc/whatsnew/3.6.rst +++ b/Doc/whatsnew/3.6.rst @@ -818,7 +818,7 @@ Notable changes in the :mod:`asyncio` module since Python 3.5.0 (all backported to 3.5.x due to the provisional status): * The :func:`~asyncio.get_event_loop` function has been changed to - always return the currently running loop when called from couroutines + always return the currently running loop when called from coroutines and callbacks. (Contributed by Yury Selivanov in :issue:`28613`.)