nu_protocol/pipeline/
out_dest.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
use std::{fs::File, io, process::Stdio, sync::Arc};

/// Describes where to direct the stdout or stderr output stream of external command to.
#[derive(Debug, Clone)]
pub enum OutDest {
    /// Redirect the stdout and/or stderr of one command as the input for the next command in the pipeline.
    ///
    /// The output pipe will be available as the `stdout` of [`ChildProcess`](crate::process::ChildProcess).
    ///
    /// If stdout and stderr are both set to `Pipe`,
    /// then they will combined into the `stdout` of [`ChildProcess`](crate::process::ChildProcess).
    Pipe,
    /// Redirect the stdout and/or stderr of one command as the input for the next command in the pipeline.
    ///
    /// The output stream(s) will be available in the `stdout` or `stderr` of [`ChildProcess`](crate::process::ChildProcess).
    ///
    /// This is similar to `Pipe` but will never combine stdout and stderr
    /// or place an external command's stderr into `stdout` of [`ChildProcess`](crate::process::ChildProcess).
    PipeSeparate,
    /// Signifies the result of the pipeline will be immediately collected into a value after this command.
    ///
    /// So, it is fine to collect the stream ahead of time in the current command.
    Value,
    /// Ignore output.
    ///
    /// This will forward output to the null device for the platform.
    Null,
    /// Output to nushell's stdout or stderr (only for external commands).
    ///
    /// This causes external commands to inherit nushell's stdout or stderr. This also causes
    /// [`ListStream`](crate::ListStream)s to be drained, but not to be printed.
    Inherit,
    /// Print to nushell's stdout or stderr.
    ///
    /// This is just like `Inherit`, except that [`ListStream`](crate::ListStream)s and
    /// [`Value`](crate::Value)s are also printed.
    Print,
    /// Redirect output to a file.
    File(Arc<File>), // Arc<File>, since we sometimes need to clone `OutDest` into iterators, etc.
}

impl From<File> for OutDest {
    fn from(file: File) -> Self {
        Arc::new(file).into()
    }
}

impl From<Arc<File>> for OutDest {
    fn from(file: Arc<File>) -> Self {
        Self::File(file)
    }
}

impl TryFrom<&OutDest> for Stdio {
    type Error = io::Error;

    fn try_from(out_dest: &OutDest) -> Result<Self, Self::Error> {
        match out_dest {
            OutDest::Pipe | OutDest::PipeSeparate | OutDest::Value => Ok(Self::piped()),
            OutDest::Null => Ok(Self::null()),
            OutDest::Print | OutDest::Inherit => Ok(Self::inherit()),
            OutDest::File(file) => Ok(file.try_clone()?.into()),
        }
    }
}