summaryrefslogtreecommitdiffstats
path: root/Doc/library/asyncio-dev.rst
diff options
context:
space:
mode:
authorVictor Stinner <victor.stinner@gmail.com>2014-02-19 22:15:02 (GMT)
committerVictor Stinner <victor.stinner@gmail.com>2014-02-19 22:15:02 (GMT)
commit7ef60cd8c208d22672e76fcf031b4fa671a13684 (patch)
tree450d12c31c3fe734566c85bcc0d04c4301a37836 /Doc/library/asyncio-dev.rst
parentf4558e8b54da0a7caf800c80589d934186b16f79 (diff)
downloadcpython-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.rst10
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