python / python/cpython

`StreamWriter.start_tls` should allow overriding `server_side`

Open
#155,896 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

stdlib topic-asyncio type-feature
Dominant language
Python
Stars
77.2k
Forks
35.9k
PR merge metrics
PR metrics pending

Description

Feature or enhancement

Proposal:

start_tls() is used to upgrade a connection to a secure version.
Currently the server_side parameter is calculated based on the existence of a callback which is only set by start_server().

While for most cases the server should be performing the server role for the TLS handshake, there's a few instances the opposite is desired.

For my personal use case I've duplicated the logic and added a new kwarg to set it manually and it works.

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Locate the StreamWriter.start_tls entry point and inspect how start_server supplies server_side. Define the smallest public-API change that allows an explicit override while preserving current behavior, add focused coverage for the client and server roles, and run the relevant asyncio tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
networking
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.