summaryrefslogtreecommitdiffstats
path: root/Doc/library/asyncio.rst
diff options
context:
space:
mode:
authorGuido van Rossum <guido@dropbox.com>2013-11-22 19:47:22 (GMT)
committerGuido van Rossum <guido@dropbox.com>2013-11-22 19:47:22 (GMT)
commit7a465647e47957e95acc3ae0f84d945b0c47707d (patch)
tree3c8ede712d84c77471c71f5deaad37508297a2af /Doc/library/asyncio.rst
parent873d1226b7cd42c663a4e09fa43a561de2e9f463 (diff)
downloadcpython-7a465647e47957e95acc3ae0f84d945b0c47707d.zip
cpython-7a465647e47957e95acc3ae0f84d945b0c47707d.tar.gz
cpython-7a465647e47957e95acc3ae0f84d945b0c47707d.tar.bz2
asyncio: Pass cancellation from wrapping Future to wrapped Future. By Saúl Ibarra Corretgé (mostly).
Diffstat (limited to 'Doc/library/asyncio.rst')
-rw-r--r--Doc/library/asyncio.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst
new file mode 100644
index 0000000..0decdc7
--- /dev/null
+++ b/Doc/library/asyncio.rst
@@ -0,0 +1,20 @@
+:mod:`asyncio` -- Asynchronous I/O, event loop, coroutines and tasks
+====================================================================
+
+.. module:: asyncio
+ :synopsis: Asynchronous I/O, event loop, coroutines and tasks.
+
+.. versionadded:: 3.4
+
+
+Introduction
+------------
+
+This package includes a pluggable event loop, transport and protocol
+abstractions similar to those in Twisted, and a higher-level scheduler
+for coroutines and tasks based on ``yield from`` (:PEP:`380`).
+
+Full documentation is not yet ready; we hope to have it written
+before Python 3.4 leaves beta. Until then, the best reference is
+:PEP:`3156`. For a motivational primer on transports and protocols,
+see :PEP:`3153`.