diff options
author | Victor Stinner <victor.stinner@gmail.com> | 2014-02-19 22:15:02 (GMT) |
---|---|---|
committer | Victor Stinner <victor.stinner@gmail.com> | 2014-02-19 22:15:02 (GMT) |
commit | 7ef60cd8c208d22672e76fcf031b4fa671a13684 (patch) | |
tree | 450d12c31c3fe734566c85bcc0d04c4301a37836 /Doc/library/asyncio-dev.rst | |
parent | f4558e8b54da0a7caf800c80589d934186b16f79 (diff) | |
download | cpython-7ef60cd8c208d22672e76fcf031b4fa671a13684.zip cpython-7ef60cd8c208d22672e76fcf031b4fa671a13684.tar.gz cpython-7ef60cd8c208d22672e76fcf031b4fa671a13684.tar.bz2 |
asyncio, Tulip issue #136: Add get/set_debug() methods to BaseEventLoopTests.
Add also a PYTHONASYNCIODEBUG environment variable to debug coroutines since
Python startup, to be able to debug coroutines defined directly in the asyncio
module.
Diffstat (limited to 'Doc/library/asyncio-dev.rst')
-rw-r--r-- | Doc/library/asyncio-dev.rst | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/Doc/library/asyncio-dev.rst b/Doc/library/asyncio-dev.rst index 90bae84..c5f0d1a 100644 --- a/Doc/library/asyncio-dev.rst +++ b/Doc/library/asyncio-dev.rst @@ -1,5 +1,7 @@ .. currentmodule:: asyncio +.. _asyncio-dev: + Develop with asyncio ==================== @@ -81,10 +83,10 @@ Detect coroutine objects never scheduled When a coroutine function is called but not passed to :func:`async` or to the :class:`Task` constructor, it is not scheduled and it is probably a bug. -To detect such bug, set :data:`asyncio.tasks._DEBUG` to ``True``. When the -coroutine object is destroyed by the garbage collector, a log will be emitted -with the traceback where the coroutine function was called. See the -:ref:`asyncio logger <asyncio-logger>`. +To detect such bug, set the environment variable :envvar:`PYTHONASYNCIODEBUG` +to ``1``. When the coroutine object is destroyed by the garbage collector, a +log will be emitted with the traceback where the coroutine function was called. +See the :ref:`asyncio logger <asyncio-logger>`. The debug flag changes the behaviour of the :func:`coroutine` decorator. The debug flag value is only used when then coroutine function is defined, not when |