Description

notatallshaw

opened on Nov 10, 2026

Issue body actions

The custom-context client example wraps a new socket and immediately prints ssock.version(). It never calls connect(), so version() returns None and no TLS connection is made.

The SSLContext.wrap_socket() description also says that "context construction" is deferred for an unconnected client socket. The context already exists; CPython creates the underlying SSL object when SSLSocket.connect() is called. The example should connect before printing the negotiated version, and the description should name the deferred operation.

Linked PRs

• gh-161763: Correct SSL docs for unconnected client sockets #161772
• [3.15] gh-161763: Correct SSL docs for unconnected client sockets (#GH-61772) #161838
• [3.14] gh-161763: Correct SSL docs for unconnected client sockets (#GH-61772) #161839

Activity

1. notatallshaw commented on Nov 10, 2026

   

   notatallshaw

   on Nov 10, 2026

   ContributorAuthor

   More actions

   This came up reviewing an error that can happen in truststore: sethmlarson/truststore#271
2. notatallshaw

   added a commit that references this issue on Nov 10, 2026

   pythongh-161763: Qualify SSL socket method references

   c883649
3. StanFromIreland

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   topic-SSL

   on Nov 10, 2026
4. github-project-automation

   added this to docs issueson Nov 10, 2026
5. github-project-automation

   moved this to Todo in docs issueson Nov 10, 2026
6. gpshead

   added 3 commits that reference this issue on Nov 12, 2026

   gh-161763: Correct SSL docs for unconnected client sockets (#GH-61772)

   f112215

   [3.15] gh-161763: Correct SSL docs for unconnected client sockets (#G…

   f49bb59

   [3.14] gh-161763: Correct SSL docs for unconnected client sockets (#G…

   83b1e74
7. orsenthil

   added a commit that references this issue on Nov 12, 2026

   pythongh-161763: Correct SSL docs for unconnected client sockets (#py…

   2753730

Issue actions