Armin Ronacher added the comment: I am not even sure what the function is supposed to tell me. The documentation is very unclear and the example code does not help. What is "fs" for instance? And why would it return things that are not from fs? ---------- nosy: +aronacher _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27589> _______________________________________

Hynek Schlawack added the comment: Such an idiom is IMHO not the main usefulness of this function tho. As an (untested) example, something like async def f(n): await asyncio.sleep(n) return n for f in asyncio.as_completed([f(3), f(2), f(1)]): print(await f) will print: 1 2 3 That’s *super* useful if you’re coordinating multiple independent external systems and need to process their results as soon as they arrive (and not once they’re *all* done). Maybe it always worked by accident for me but it’s my understanding, that that is what this function is for (and I haven’t found another way to achieve it). That’s why it would be nice if there’d be authoritative docs on what it’s supposed to do. :) ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27589> _______________________________________

Karthikeyan Singaravelan <tir.karthi@gmail.com> added the comment: Current docs read as below with an example to show that earliest future is returned. I guess this can be closed. https://docs.python.org/dev/library/asyncio-task.html#asyncio.as_completed Run awaitable objects in the aws set concurrently. Return an iterator of Future objects. Each Future object returned represents the earliest result from the set of the remaining awaitables. ---------- nosy: +asvetlov, xtreak _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue27589> _______________________________________