Incorrect / incomplete documentation of asyncio.Server

[romuald]

Documentation

URL: https://docs.python.org/3.7/library/asyncio-eventloop.html#asyncio.Server.sockets

The documentation states that sockets is a list of socket.socket objects

The actual type is a list of asyncio.trsock.TransportSocket (that is not documented)

We should add the missing documentation to the asyncio.trsock module, and make the proper relationship in the Server section

Linked PRs

• gh-101786: Clarify docs that asyncio.Server.sockets is a socket-like TransportSocket #103877
• [3.11] gh-101786: Clarify docs that asyncio.Server.sockets is a socket-like TransportSocket (GH-103877) #103890

[gvanrossum]

I recall stumbling over this too once. I think the intention is that TransportSocket is completely transparent (in a duck-type way :-), but the docs should not lie.

[kumaraditya303]

Maybe change it to socket-like object if we are not documenting the whole TransportSocket?