Tracking Issue for anonymous pipe API

[NobodyXu]

This is a tracking issue for the ACP rust-lang/libs-team#375 .
The feature gate for the issue is #![feature(anonymous_pipe)].

// std::pipe

fn pipe() -> io::Result<(PipeReader, PipeWriter)>;

struct PipeReader {...}
struct PipeWriter {...}

impl PipeReader {
    fn try_clone(&self) -> io::Result<Self>;
}

impl PipeWriter {
    fn try_clone(&self) -> io::Result<Self>;
}

impl Read for &PipeReader
impl Read for PipeReader
impl Debug for PipeReader
impl From<PipeReader> for Stdio

impl Write for &PipeWriter
impl Write for PipeWriter
impl Debug for PipeWriter
impl From<PipeWriter> for Stdio

// unix {
impl AsFd for PipeReader
impl AsRawFd for PipeReader
impl FromRawFd for PipeReader
impl IntoRawFd for PipeReader
impl From<PipeReader> for OwnedFd
impl From<OwnedFd> for PipeReader

impl AsFd for PipeWriter
impl AsRawFd for PipeWriter
impl FromRawFd for PipeWriter
impl IntoRawFd for PipeWriter
impl From<PipeWriter> for OwnedFd
impl From<OwnedFd> for PipeWriter
// }

// windows {
impl AsHandle for PipeReader
impl AsRawHandle for PipeReader
impl FromRawHandle for PipeReader
impl IntoRawHandle for PipeReader
impl From<PipeReader> for OwnedHandle
impl From<OwnedHandle> for PipeReader

impl AsHandle for PipeWriter
impl AsRawHandle for PipeWriter
impl FromRawHandle for PipeWriter
impl IntoRawHandle for PipeWriter
impl From<PipeWriter> for OwnedHandle
impl From<OwnedHandle> for PipeWriter
// }

Steps

• Implement the ACP Initial implementation of anonymous_pipe API #127153
• Enable std::io::copy specialisation Enable std::io::copy specialisation for std::pipe::{PipeReader, PipeWriter} #128303
• Adjust documentation Add documentation for anonymous pipe module #133986 (see instructions on rustc-dev-guide)
• Move pipe API into std::io Move std::pipe::* into std::io #135583
• Stabilization PR Stabilize anonymous_pipe #135822 (see instructions on rustc-dev-guide)

Implementation history

• Initial implementation of anonymous_pipe API #127153
• Enable std::io::copy specialisation for std::pipe::{PipeReader, PipeWriter} #128303

[Fulgen301]

You might want to fix the typo in the title and feature name - it's an anonymous pipe, not an annoymous pipe.

[NobodyXu]

Thanks!

I've fixed the typo in this issue and the linked PR.

[NobodyXu]

I think we can now add specialisation to std::io::copy for std::pipe

[NobodyXu]

I'm thinking about a new method for checked conversion from OwnedFd on unix.

I think it would be quite helpful for jobserver-rs

[RalfJung]

Currently the documentation for this module is very bare-bones, quite far from the depth and quality we are used to in other parts of the standard library. There's not even a single example. This should be resolved before stabilization.

[joboet]

@rust-lang/libs-api were the system-specific trait implementations (e.g. From<OwnedFd>, From<OwnedHandle>) also part of the FCP? And could you confirm that you are okay with establishing this pattern, considering that File does not have such implementations? For what it's worth I have nothing against those implementations, but they are unprecedented...

@rustbot label +I-libs-api-nominated

My bad, I overlooked them...

[joshtriplett]

https://doc.rust-lang.org/std/os/fd/struct.OwnedFd.html#impl-From%3COwnedFd%3E-for-File ? Or do you mean something else?

[joboet]

Oh dang, sorry, I totally overlooked that. Nevermind!

[LevitatingBusinessMan]

Did something happen to this experimental api?

The example code at https://doc.rust-lang.org/stable/std/pipe/index.html does not seem to compile anymore.

[NobodyXu]

It has been moved into std::io

https://doc.rust-lang.org/nightly/std/io/fn.pipe.html