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.

Author vstinner
Recipients Ron Frederick, gvanrossum, vstinner, yselivanov
Date 2015-11-27.22:18:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <CAMpsgwb3EMF4SajbVUudXtwLiiGmWqB8q=Sp9nRwJ6f2cB4oSg@mail.gmail.com>
In-reply-to <1448652746.7.0.950083632844.issue25749@psf.upfronthosting.co.za>
Content
Yeah, I recall this point. The doc points to Server, but Guido didn't
want to expose "implementation details" of Server like sockets.
Different implementations of event loops (Yury gave the good example
of uvloop based on libuv) don't give (direct) access to sockets.

The problem is maybe that we try to document two different things at
the same place: asyncio "portable" API (the PEP 3156), and the
implementation of "default" event loops.

Even if it's not possible to directly use server sockets, it's kind of
useful to get them. What do you think?

Server.sockets is documented at:
https://docs.python.org/dev/library/asyncio-eventloop.html#asyncio.Server.sockets

Server.sockets is explicitly documented at:
https://docs.python.org/dev/library/asyncio-eventloop.html#asyncio.BaseEventLoop.create_server

I would prefer to keep the Server.sockets doc, but explain better that
it's an "implementation detail". We already have something similar for
"CPython" implementation details in the doc. Examples:
- https://docs.python.org/dev/library/sys.html#sys._debugmallocstats
- https://docs.python.org/dev/library/sys.html#sys._getframe
- https://docs.python.org/dev/library/dis.html#module-dis
- etc.

What do you think of reusing the ".. impl-detail:" markup? Or do you
prefer to write a different kind of box for asyncio? Or just not box
and a simple sentence?
History
Date User Action Args
2015-11-27 22:18:54vstinnersetrecipients: + vstinner, gvanrossum, yselivanov, Ron Frederick
2015-11-27 22:18:54vstinnerlinkissue25749 messages
2015-11-27 22:18:54vstinnercreate