From: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Date: Mon, 23 Jan 2023 11:52:38 +0000 (+0530)
Subject: [3.10] Added asyncio REPL example to docs. (GH-101243) (#101257)
X-Git-Tag: v3.10.10~25
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e24c73e71e952028bc702a741241ff79c23eb30e;p=thirdparty%2FPython%2Fcpython.git

[3.10] Added asyncio REPL example to docs. (GH-101243) (#101257)

(cherry picked from commit 5d868efde9ea08b39357b962a02a0294aa97689c)

Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es>
---

diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst
index a6429394389b..8a6526ed9022 100644
--- a/Doc/library/asyncio.rst
+++ b/Doc/library/asyncio.rst
@@ -56,6 +56,17 @@ Additionally, there are **low-level** APIs for
 * :ref:`bridge <asyncio-futures>` callback-based libraries and code
   with async/await syntax.
 
+You can experiment with an ``asyncio`` concurrent context in the REPL:
+
+.. code-block:: pycon
+
+   $ python -m asyncio
+   asyncio REPL ...
+   Use "await" directly instead of "asyncio.run()".
+   Type "help", "copyright", "credits" or "license" for more information.
+   >>> import asyncio
+   >>> await asyncio.sleep(10, result='hello')
+   'hello'
 
 .. We use the "rubric" directive here to avoid creating
    the "Reference" subsection in the TOC.