Struct bawawa::Process

pub struct Process { /* fields omitted */ }

a Process object to monitor the execution of a Command.

If the Process is dropped, the associated Process will be terminated.

A process is a future where the output Item is the exit status.

Methods

impl Process

pub fn spawn(command: Command) -> Result<Self>

attempt to run the given Command.

Error

the function may fail if between the time the Program object was constructed and the call of this function the program situation as changed (permission, renamed, removed...).

pub fn stdin(&mut self) -> &mut Option<ChildStdin>

pub fn stdout(&mut self) -> &mut Option<ChildStdout>

pub fn stderr(&mut self) -> &mut Option<ChildStderr>

Trait Implementations

impl Control for Process

fn command(&self) -> &Command

access the underlying command settings

fn id(&self) -> u32

Returns the OS-assigned process identifier associated with this process.

fn kill(&mut self) -> Result<()>

force the process to finish

this is equivalent to SIGKILL on unix platform

impl<'a> StandardInput<'a> for Process

fn standard_input(&mut self) -> &mut ChildStdin

get access to the standard input so we can send in data

fn framed_stdin<E, Item>(
    &mut self,
    encoder: E
) -> FramedWrite<&mut ChildStdin, E> where
    E: Encoder<Item = Item>, 

fn send_stdin<E, Item>(self, encoder: E) -> SendStdin<'a, Self, E, Item> where
    E: Encoder<Item = Item>, 

impl<'a> StandardOutput<'a> for Process

fn standard_output(&mut self) -> &mut ChildStdout

get access to the standard output

fn framed_stdout<D, Item>(
    &mut self,
    decoder: D
) -> FramedRead<&mut ChildStdout, D> where
    D: Decoder<Item = Item>, 

fn capture_stdout<D, Item>(
    self,
    decoder: D
) -> Capture<'a, Self, D, ChildStdout, Item> where
    D: Decoder<Item = Item>, 

impl<'a> StandardError<'a> for Process

fn standard_error(&mut self) -> &mut ChildStderr

get access to the standard output

fn framed_stderr<D, Item>(
    &mut self,
    decoder: D
) -> FramedRead<&mut ChildStderr, D> where
    D: Decoder<Item = Item>, 

fn capture_stderr<D, Item>(
    self,
    decoder: D
) -> Capture<'a, Self, D, ChildStderr, Item> where
    D: Decoder<Item = Item>, 

impl Future for Process

type Item = <Child as Future>::Item

The type of value that this future will resolved with if it is successful.

type Error = Error

The type of error that this future will resolve with if it fails in a normal fashion.

fn poll(&mut self) -> Poll<Self::Item, Self::Error>

Query this future to see if its value has become available, registering interest if it is not.

fn wait(self) -> Result<Self::Item, Self::Error>

Block the current thread until this future is resolved.

fn map<F, U>(self, f: F) -> Map<Self, F> where
    F: FnOnce(Self::Item) -> U, 

Map this future's result to a different type, returning a new future of the resulting type.

fn map_err<F, E>(self, f: F) -> MapErr<Self, F> where
    F: FnOnce(Self::Error) -> E, 

Map this future's error to a different error, returning a new future.

fn from_err<E>(self) -> FromErr<Self, E> where
    E: From<Self::Error>, 

Map this future's error to any error implementing From for this future's Error, returning a new future.

fn then<F, B>(self, f: F) -> Then<Self, B, F> where
    B: IntoFuture,
    F: FnOnce(Result<Self::Item, Self::Error>) -> B, 

Chain on a computation for when a future finished, passing the result of the future to the provided closure f.

fn and_then<F, B>(self, f: F) -> AndThen<Self, B, F> where
    B: IntoFuture<Error = Self::Error>,
    F: FnOnce(Self::Item) -> B, 

Execute another future after this one has resolved successfully.

fn or_else<F, B>(self, f: F) -> OrElse<Self, B, F> where
    B: IntoFuture<Item = Self::Item>,
    F: FnOnce(Self::Error) -> B, 

Execute another future if this one resolves with an error.

fn select<B>(self, other: B) -> Select<Self, <B as IntoFuture>::Future> where
    B: IntoFuture<Item = Self::Item, Error = Self::Error>, 

Waits for either one of two futures to complete.

fn select2<B>(self, other: B) -> Select2<Self, <B as IntoFuture>::Future> where
    B: IntoFuture, 

Waits for either one of two differently-typed futures to complete.

fn join<B>(self, other: B) -> Join<Self, <B as IntoFuture>::Future> where
    B: IntoFuture<Error = Self::Error>, 

Joins the result of two futures, waiting for them both to complete.

fn join3<B, C>(
    self,
    b: B,
    c: C
) -> Join3<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future> where
    B: IntoFuture<Error = Self::Error>,
    C: IntoFuture<Error = Self::Error>, 

Same as join, but with more futures.

fn join4<B, C, D>(
    self,
    b: B,
    c: C,
    d: D
) -> Join4<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future> where
    B: IntoFuture<Error = Self::Error>,
    C: IntoFuture<Error = Self::Error>,
    D: IntoFuture<Error = Self::Error>, 

Same as join, but with more futures.

fn join5<B, C, D, E>(
    self,
    b: B,
    c: C,
    d: D,
    e: E
) -> Join5<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future, <E as IntoFuture>::Future> where
    B: IntoFuture<Error = Self::Error>,
    C: IntoFuture<Error = Self::Error>,
    D: IntoFuture<Error = Self::Error>,
    E: IntoFuture<Error = Self::Error>, 

Same as join, but with more futures.

fn into_stream(self) -> IntoStream<Self>

Convert this future into a single element stream.

fn flatten(self) -> Flatten<Self> where
    Self::Item: IntoFuture,
    <Self::Item as IntoFuture>::Error: From<Self::Error>, 

Flatten the execution of this future when the successful result of this future is itself another future.

fn flatten_stream(self) -> FlattenStream<Self> where
    Self::Item: Stream,
    <Self::Item as Stream>::Error == Self::Error, 

Flatten the execution of this future when the successful result of this future is a stream.

fn fuse(self) -> Fuse<Self>

Fuse a future such that poll will never again be called once it has completed.

fn inspect<F>(self, f: F) -> Inspect<Self, F> where
    F: FnOnce(&Self::Item), 

Do something with the item of a future, passing it on.

fn catch_unwind(self) -> CatchUnwind<Self> where
    Self: UnwindSafe, 

Catches unwinding panics while polling the future.

fn shared(self) -> Shared<Self>

Create a cloneable handle to this future where all handles will resolve to the same result.