<DISCLAIMER>I am not a Python core developer, but my question relates to changes that are expected in Python 3.10, so I felt this was the best forum to ask. Please let me know if I should discuss this elsewhere or file a documentation bug.</DISCLAIMER>
First of all, thank you Yuri Selivanov and everybody who contributed to the overhaul of the asyncio docs which are now much better organized. In the process of updating "Fluent Python" to cover Python 3.9, I learned that the "Generator-based coroutines" section in the asyncio docs warns that "Support for generator-based coroutines is deprecated and is scheduled for removal in Python 3.10." [1] [1] https://docs.python.org/3/library/asyncio-task.html#generator-based-coroutines I don't understand that warning, given that PEP 492 lists as one of the awaitable types: * A generator-based coroutine object returned from a function decorated with types.coroutine(). Perhaps what is going to be removed is support for old style generator-based coroutines decorated with @asyncio.coroutine, or not decorated (which historically also worked)? I'd appreciate some clarification on exactly what is going to be removed. Maybe we also need updates to the Glossary [2] to bridge the gap between our previous use of the word "coroutine" (as in PEP 342) and the way we are using it today, when we are not being explicit about "native coroutines". In particular, the Glossary has no entry at all for "generator-based coroutine"—those marked with @types.coroutine. [2] https://docs.python.org/3/glossary.html Thank you for your time and help! Cheers, Luciano -- Luciano Ramalho | Author of Fluent Python (O'Reilly, 2015) | http://shop.oreilly.com/product/0636920032519.do | Technical Principal at ThoughtWorks | Twitter: @ramalhoorg _______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/VTDU43WYRSHUQWJT4356GR3NS5C42M6N/ Code of Conduct: http://python.org/psf/codeofconduct/