diff options
author | Victor Stinner <victor.stinner@gmail.com> | 2014-10-12 19:37:16 (GMT) |
---|---|---|
committer | Victor Stinner <victor.stinner@gmail.com> | 2014-10-12 19:37:16 (GMT) |
commit | ab1c85307948219ecf15608b7f7aad41fb8c8670 (patch) | |
tree | 4218c6eb3a645b307a15a8a0ebe0fd4952d883b8 | |
parent | 980dd84f92f689f810ebf10a15f221c8d396ce4e (diff) | |
download | cpython-ab1c85307948219ecf15608b7f7aad41fb8c8670.zip cpython-ab1c85307948219ecf15608b7f7aad41fb8c8670.tar.gz cpython-ab1c85307948219ecf15608b7f7aad41fb8c8670.tar.bz2 |
asyncio doc: update debug traces
-rw-r--r-- | Doc/library/asyncio-dev.rst | 43 |
1 files changed, 27 insertions, 16 deletions
diff --git a/Doc/library/asyncio-dev.rst b/Doc/library/asyncio-dev.rst index b797d6a..8ec2ff0 100644 --- a/Doc/library/asyncio-dev.rst +++ b/Doc/library/asyncio-dev.rst @@ -166,26 +166,35 @@ Example of unhandled exception:: Output:: Task exception was never retrieved - future: <Task finished bug() done at asyncio/coroutines.py:139 exception=Exception('not consumed',)> + future: <Task finished coro=<coro() done, defined at asyncio/coroutines.py:139> exception=Exception('not consumed',)> + Traceback (most recent call last): + File "asyncio/tasks.py", line 237, in _step + result = next(coro) + File "asyncio/coroutines.py", line 141, in coro + res = func(*args, **kw) + File "test.py", line 5, in bug + raise Exception("not consumed") + Exception: not consumed + +:ref:`Enable the debug mode of asyncio <asyncio-debug-mode>` to get the +traceback where the task was created. Output in debug mode:: + + Task exception was never retrieved + future: <Task finished coro=<bug() done, defined at test.py:3> exception=Exception('not consumed',) created at test.py:8> source_traceback: Object created at (most recent call last): - File "test.py", line 10, in <module> + File "test.py", line 8, in <module> asyncio.async(bug()) - File "asyncio/tasks.py", line 510, in async - task = loop.create_task(coro_or_future) Traceback (most recent call last): - File "asyncio/tasks.py", line 244, in _step + File "asyncio/tasks.py", line 237, in _step result = next(coro) - File "coroutines.py", line 78, in __next__ + File "asyncio/coroutines.py", line 79, in __next__ return next(self.gen) File "asyncio/coroutines.py", line 141, in coro res = func(*args, **kw) - File "test.py", line 7, in bug + File "test.py", line 5, in bug raise Exception("not consumed") Exception: not consumed -:ref:`Enable the debug mode of asyncio <asyncio-debug-mode>` to get the -traceback where the task was created. - There are different options to fix this issue. The first option is to chain to coroutine in another coroutine and use classic try/except:: @@ -303,15 +312,17 @@ If a pending task is destroyed, the execution of its wrapped :ref:`coroutine Example of log:: Task was destroyed but it is pending! + task: <Task pending coro=<kill_me() done, defined at test.py:5> wait_for=<Future pending cb=[Task._wakeup()]>> + +:ref:`Enable the debug mode of asyncio <asyncio-debug-mode>` to get the +traceback where the task was created. Example of log in debug mode:: + + Task was destroyed but it is pending! source_traceback: Object created at (most recent call last): - File "test.py", line 17, in <module> + File "test.py", line 15, in <module> task = asyncio.async(coro, loop=loop) - File "asyncio/tasks.py", line 510, in async - task = loop.create_task(coro_or_future) - task: <Task pending kill_me() done at test.py:5 wait_for=<Future pending cb=[Task._wakeup()]>> + task: <Task pending coro=<kill_me() done, defined at test.py:5> wait_for=<Future pending cb=[Task._wakeup()] created at test.py:7> created at test.py:15> -:ref:`Enable the debug mode of asyncio <asyncio-debug-mode>` to get the -traceback where the task was created. .. seealso:: |