Skip to content

gh-71019: document which objects connect_read_pipe/connect_write_pipe accept and add tests#153660

Open
kumaraditya303 wants to merge 4 commits into
python:mainfrom
kumaraditya303:gh-71019-connect-pipe-docs
Open

gh-71019: document which objects connect_read_pipe/connect_write_pipe accept and add tests#153660
kumaraditya303 wants to merge 4 commits into
python:mainfrom
kumaraditya303:gh-71019-connect-pipe-docs

Conversation

@kumaraditya303

@kumaraditya303 kumaraditya303 commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

…e_pipe accept

The docs described *pipe* as simply a file-like object, which suggested that
regular files and the standard streams would work. They do not: on Unix only
pipes, sockets and character devices are accepted (anything else raises
ValueError), and on Windows only handles opened for overlapped I/O can be
associated with an I/O completion port, so console handles and file handles
fail asynchronously rather than at call time.

Spell out what is accepted on each platform and note that regular files are
never supported.
@read-the-docs-community

read-the-docs-community Bot commented Jul 13, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33562855 | 📁 Comparing 25316c9 against main (1fece44)

  🔍 Preview build  

2 files changed
± library/asyncio-eventloop.html
± library/asyncio-platforms.html

@kumaraditya303 kumaraditya303 added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels Jul 13, 2026
@kumaraditya303 kumaraditya303 marked this pull request as ready for review July 13, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting core review needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes skip news topic-asyncio

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant