Add docs about return and raise exception on asyncio.run
https://bugs.python.org/issue38260
Automerge-Triggered-By: @asvetlov
the end. It should be used as a main entry point for asyncio
programs, and should ideally only be called once.
+ Return a result of *coro* execution, or raise a :exc:`RuntimeError`
+ if ``asyncio.run()`` is called from a running event loop, or a
+ :exc:`ValueError` if *coro* is not a courutine.
+
+ Example::
+
+ async def main():
+ await asyncio.sleep(1)
+ print('hello')
+
+ asyncio.run(main())
+
.. versionadded:: 3.7
.. versionchanged:: 3.9
It should be used as a main entry point for asyncio programs, and should
ideally only be called once.
+ Return a result of *coro* execution, or raise a RuntimeError
+ if `asyncio.run()`is called from a running event loop, or a ValueError
+ if `main` is not a courutine.
+
Example:
async def main():