Issue 38260: asyncio.run documentation does not mention its return value

➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

This issue has been migrated to GitHub: https://github.com/python/cpython/issues/82441

classification

Title:	asyncio.run documentation does not mention its return value
Type:	enhancement	Stage:	resolved
Components:	asyncio, Documentation	Versions:	Python 3.7

process

Status:	closed	Resolution:	fixed
Dependencies:		Superseder:
Assigned To:	docs@python	Nosy List:	aeros, asvetlov, docs@python, eamanu, edd07, miss-islington, yselivanov
Priority:	normal	Keywords:	patch

Created on 2019-09-23 15:40 by edd07, last changed 2022-04-11 14:59 by admin. This issue is now closed.

Messages (4)
msg353033 - (view)	Author: Luis E. (edd07)	Date: 2019-09-23 15:40
The documentation for asyncio.run (https://docs.python.org/3/library/asyncio-task.html#asyncio.run) does not mention the function's return value or lack of one. Looking at the source, its clear it returns the passed coroutine's value via loop.run_until_complete, but the documentation or the provided example do not make it clear.
msg353041 - (view)	Author: Emmanuel Arias (eamanu) *	Date: 2019-09-23 20:55
So, I think that will return the Future's return, isn't? I will propose a PR for this
msg353156 - (view)	Author: miss-islington (miss-islington)	Date: 2019-09-25 08:53
New changeset 17deb16883fa574a86e42551cc37f044182347ad by Miss Islington (bot) (Emmanuel Arias) in branch 'master': bpo-38260: Add Docs on asyncio.run (GH-16337) https://github.com/python/cpython/commit/17deb16883fa574a86e42551cc37f044182347ad
msg353157 - (view)	Author: miss-islington (miss-islington)	Date: 2019-09-25 09:13
New changeset d3666945d78508970002653c4d46221a4306f55b by Miss Islington (bot) in branch '3.7': bpo-38260: Add Docs on asyncio.run (GH-16337) https://github.com/python/cpython/commit/d3666945d78508970002653c4d46221a4306f55b
msg353158 - (view)	Author: miss-islington (miss-islington)	Date: 2019-09-25 09:13
New changeset 4633355a063c7bf068bdd72dfdd32f4c22cf382f by Miss Islington (bot) in branch '3.8': bpo-38260: Add Docs on asyncio.run (GH-16337) https://github.com/python/cpython/commit/4633355a063c7bf068bdd72dfdd32f4c22cf382f

History
Date	User	Action	Args
2022-04-11 14:59:20	admin	set	github: 82441
2019-09-25 09:23:16	asvetlov	set	status: open -> closed resolution: fixed stage: patch review -> resolved
2019-09-25 09:13:04	miss-islington	set	messages: + msg353158
2019-09-25 09:13:04	miss-islington	set	messages: + msg353157
2019-09-25 08:54:18	miss-islington	set	pull_requests: + pull_request15960
2019-09-25 08:54:12	miss-islington	set	pull_requests: + pull_request15959
2019-09-25 08:53:52	miss-islington	set	nosy: + miss-islington messages: + msg353156
2019-09-23 21:05:21	eamanu	set	keywords: + patch stage: patch review pull_requests: + pull_request15914
2019-09-23 20:55:14	eamanu	set	nosy: + eamanu messages: + msg353041
2019-09-23 17:27:28	yselivanov	set	nosy: + aeros
2019-09-23 15:40:12	edd07	create