traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Apply asyncio Task English fixes to docstrings as well. 

Also fixed the phrasing in a comment.
This commit is contained in:
R David Murray 2014-09-24 13:13:45 -04:00
parent 22dd8334cd
commit 8e069d5ce9
1 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
Lib/asyncio/tasks.py
View File

@ -77,9 +77,9 @@ class Task(futures.Future):
# status is still pending # status is still pending
self._log_destroy_pending = True self._log_destroy_pending = True
# On Python 3.3 or older, objects with a destructor part of a reference # On Python 3.3 or older, objects with a destructor that are part of a
# cycle are never destroyed. It's not more the case on Python 3.4 thanks to # reference cycle are never destroyed. That's not the case any more on
# the PEP 442. # Python 3.4 thanks to the PEP 442.
if _PY34: if _PY34:
def __del__(self): def __del__(self):
if self._state == futures._PENDING and self._log_destroy_pending: if self._state == futures._PENDING and self._log_destroy_pending:
@ -155,7 +155,8 @@ class Task(futures.Future):
This produces output similar to that of the traceback module, This produces output similar to that of the traceback module,
for the frames retrieved by get_stack(). The limit argument for the frames retrieved by get_stack(). The limit argument
is passed to get_stack(). The file argument is an I/O stream is passed to get_stack(). The file argument is an I/O stream
to which the output goes; by default it goes to sys.stderr. to which the output is written; by default output is written
to sys.stderr.
""" """
extracted_list = [] extracted_list = []
checked = set() checked = set()
@ -184,18 +185,18 @@ class Task(futures.Future):
print(line, file=file, end='') print(line, file=file, end='')
def cancel(self): def cancel(self):
"""Request this task to cancel itself. """Request that this task cancel itself.
This arranges for a CancelledError to be thrown into the This arranges for a CancelledError to be thrown into the
wrapped coroutine on the next cycle through the event loop. wrapped coroutine on the next cycle through the event loop.
The coroutine then has a chance to clean up or even deny The coroutine then has a chance to clean up or even deny
the request using try/except/finally. the request using try/except/finally.
Contrary to Future.cancel(), this does not guarantee that the Unlike Future.cancel, this does not guarantee that the
task will be cancelled: the exception might be caught and task will be cancelled: the exception might be caught and
acted upon, delaying cancellation of the task or preventing it acted upon, delaying cancellation of the task or preventing
completely. The task may also return a value or raise a cancellation completely. The task may also return a value or
different exception. raise a different exception.
Immediately after this method is called, Task.cancelled() will Immediately after this method is called, Task.cancelled() will
not return True (unless the task was already cancelled). A not return True (unless the task was already cancelled). A