New submission from Yury Selivanov <yseliva...@gmail.com>: There's a handful of event loop methods that are currently documented as coroutines, but in reality they return asyncio.Future:
* loop.sock_sendall, * loop.sock_accept, * loop.sock_recv, and * loop.run_in_executor. These methods need to become proper coroutines beacause: 1. loop.create_task(loop.sock_recv(..)) fails with a cryptic error. 2. It's harder for us to refactor the code keeping these functions as regular functions returning Futures. Once asyncio was broken because of the bug in loop.sock_connect() because of a complex refactoring. After we converted it to a coroutine in 3.6, we received 0 complaints, but the code became simpler. 3. It's easier to read the source code of asyncio, when all methods that are documented as coroutines are actually coroutines. 4. This downgrades the role of 'asyncio.ensure_future()' function. Basically, when a user needs a task, they can now use create_task() (which won't fail on some "coroutines" sometimes). asyncio users will be advised to design APIs in their programs and libraries around async/await and not Future objects. ---------- assignee: yselivanov components: asyncio messages: 308339 nosy: yselivanov priority: normal severity: normal status: open title: Make asyncio methods documented as coroutines - coroutines. versions: Python 3.7 _______________________________________ Python tracker <rep...@bugs.python.org> <https://bugs.python.org/issue32327> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
