add debug mode

Author: vstinner

Diff for: debug_mode.rst

@@ -0,0 +1,11 @@
+++++++++++++++++++
+Asyncio Debug Mode
+++++++++++++++++++
+
+* Set the environment variable: ``PYTHONASYNCIODEBUG=1``
+* Configure Python logging:
+  ``logging.basicConfig(level=logging.ERROR)``
+
+See also: `Debug mode of asyncio (ref doc)
+<https://docs.python.org/dev/library/asyncio-dev.html#debug-mode-of-asyncio>`_.
+

Diff for: index.rst

@@ -17,13 +17,15 @@ Chapiter 1: First steps with asyncio
    twisted.rst
    getting_help.rst
 
+
 Chapiter 2: Advanced topics
 ===========================
 
 .. toctree::
    :maxdepth: 2
 
    threads.rst
+   debug_mode.rst
 
 
 See also

Diff for: threads.rst

@@ -6,3 +6,9 @@ Run slow CPU-intensive or blocking I/O code in a thread:
 
 .. literalinclude:: examples/run_in_thread.py
 
+See also:
+
+* `run_in_executor() documentation
+  <https://docs.python.org/dev/library/asyncio-eventloop.html#asyncio.BaseEventLoop.run_in_executor>`_
+* `asyncio: Concurrency and multithreading
+  <https://docs.python.org/dev/library/asyncio-dev.html#concurrency-and-multithreading>`_