[issue25501] Use async/await through asyncio docs

[Brett Cannon]

Changes by Brett Cannon :


--
resolution:  -> wont fix
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue25501] Use async/await through asyncio docs

[Guido van Rossum]

Guido van Rossum added the comment:

Honestly I think it's better if most people keep using coroutine/yield-from 
instead of async/await for a few more releases; their code will be more 
portable, since it takes forever to update old datacenters. We put in 
async/await with an eye towards the future. But we're keeping yield-from around 
for a long time too. And that's also why we support asyncio for 3.3.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue25501] Use async/await through asyncio docs

[Brett Cannon]

Brett Cannon added the comment:

Once 3.4.4 launches the need to keep the docs synced with a version that 
doesn't support async/await goes away. And worrying about 3.3 isn't necessary 
since asyncio was added in 3.4.

So once 3.4.4 is released and we close the 3.4 branch to bugfixes can we update 
the docs in asyncio and add a note at the top saying the examples all use 
async/await from 3.5 and if you need 3.4 compatibility to please look at the 
3.4 docs? Otherwise how long do you want to wait until we can start using 
async/await in the documentation? My worry is that people are going to blindly 
copy the examples and tweak them for their needs since the asyncio docs are a 
bit dense and thus just simply overlook the fact that async/await exists.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue25501] Use async/await through asyncio docs

[Andrew Svetlov]

Andrew Svetlov added the comment:

We have dropped 3.3 in aiohttp BTW.
Proper handling of resource leaks is too annoying without PEP 442 which don't 
crash with core dump starting from Python 3.4.1

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue25501] Use async/await through asyncio docs

[Andrew Svetlov]

Andrew Svetlov added the comment:

Also sphinx (pygments actually) still do not support async/await syntax 
highlighting yet.

--
nosy: +asvetlov

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue25501] Use async/await through asyncio docs

[Guido van Rossum]

Guido van Rossum added the comment:

It makes it more awkward to keep the asyncio docs in sync between 3.4 and 3.5. 
Also it makes copying examples harder for users who need compatibility with 3.4 
or 3.3.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue25501] Use async/await through asyncio docs

[Ezio Melotti]

Changes by Ezio Melotti :


--
keywords: +easy
nosy: +ezio.melotti
type:  -> enhancement

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue25501] Use async/await through asyncio docs

[Brett Cannon]

New submission from Brett Cannon:

The asyncio docs still use `yield from` and @asyncio.coroutine all over the 
place instead of async/await. It would be best to update the docs to follow 
best practices (unless there is some reason I can't think of as to why this 
hasn't happened yet).

--
assignee: docs@python
components: Documentation
messages: 253636
nosy: brett.cannon, docs@python, giampaolo.rodola, gvanrossum, haypo, pitrou, 
yselivanov
priority: normal
severity: normal
stage: needs patch
status: open
title: Use async/await through asyncio docs
versions: Python 3.6

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com