Author gvanrossum
Recipients gvanrossum, haypo, j1m, yselivanov
Date 2016-06-29.18:15:43
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1467224143.6.0.316503597765.issue27392@psf.upfronthosting.co.za>
In-reply-to
Content
Hm. The docs in PEP 3156 do mention that create_connection() is for clients (though it weakens this with "typically"): https://www.python.org/dev/peps/pep-3156/#internet-connections

I always think of TCP connections (which is what create_connection() is about) as essentially asymmetrical -- the server uses bind() and listen() and then sits in an accept() loop accepting connections, while the client reaches out to the server using connect(). And create_connection() is a wrapper around that connect() call; for servers we have create_server(). (The asymmetry in naming reflects the asymmetry in functionality and API.)

You can pass a pre-connected socket in to create_connection() for edge cases where you need control over how the socket is created and initialized or when there's a 3rd party library that can give you a connected socket that you want/need to use. Similarly, you can pass a pre-bound socket to create_server().

I guess at the lower, TCP level, there isn't much of a difference between a client-side socket and the kind of server-side socket that's returned by accept(). And maybe that's also the case for SSL (I've never actually understood most of the details of using SSL).

Maybe it's just culture shock? Or maybe we just need a public API that roughly represents the pair of calls to _make_ssl_transport() and _make_socket_transport() that are currently appearing both in _create_connection_transport() and in _accept_connection2(), plus some of the code around it that's a little tricky?
History
Date User Action Args
2016-06-29 18:15:43gvanrossumsetrecipients: + gvanrossum, haypo, j1m, yselivanov
2016-06-29 18:15:43gvanrossumsetmessageid: <1467224143.6.0.316503597765.issue27392@psf.upfronthosting.co.za>
2016-06-29 18:15:43gvanrossumlinkissue27392 messages
2016-06-29 18:15:43gvanrossumcreate