iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

pep 525: Fix formatting

This commit is contained in:
Yury Selivanov 2016-09-06 17:09:13 -07:00
parent be5a9b53d3
commit 8f8cdb00ed
1 changed files with 14 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
pep-0525.txt
View File

@ -260,20 +260,22 @@ with ``firstiter`` and ``finalizer`` fields.
asyncio asyncio
------- -------
The asyncio event loop will use ``sys.set_asyncgen_hooks()`` API to maintain The asyncio event loop will use ``sys.set_asyncgen_hooks()`` API to
a weak set of all scheduled asynchronous generators, and to schedule their maintain a weak set of all scheduled asynchronous generators, and to
``aclose()`` coroutine methods when it is time for generators to be GCed. schedule their ``aclose()`` coroutine methods when it is time for
generators to be GCed.
To make sure that asyncio programs can finalize all scheduled asynchronous To make sure that asyncio programs can finalize all scheduled
generators reliably, we propose to add a new event loop method asynchronous generators reliably, we propose to add a new event loop
``loop.shutdown_asyncgens(*, timeout=30)``. The method will schedule all method ``loop.shutdown_asyncgens(*, timeout=30)``. The method will
currently open asynchronous generators to close with an ``aclose()`` call. schedule all currently open asynchronous generators to close with an
``aclose()`` call.
After calling the ``loop.shutdown_asyncgens()`` method, the event loop will After calling the ``loop.shutdown_asyncgens()`` method, the event loop
issue a warning whenever a new asynchronous generator is iterated for the first will issue a warning whenever a new asynchronous generator is iterated
time. The idea is that after requesting all asynchronous generators to be for the first time. The idea is that after requesting all asynchronous
shutdown, the program should not execute code that iterates over new generators to be shutdown, the program should not execute code that
asynchronous generators. iterates over new asynchronous generators.
An example of how ``shutdown_asyncgens`` should be used:: An example of how ``shutdown_asyncgens`` should be used::