Struct ExecSpec

Source
pub struct ExecSpec {
    pub working_dir: PathBuf,
    pub executable: OsString,
    pub clargs: Vec<OsString>,
    pub env: HashMap<String, String>,
    pub input: Input,
    pub output: Output,
    pub output_err: Output,
}
Expand description

The exec spec helps define something to execute by the project

Fields§

§working_dir: PathBuf

The working directory to run the executable in

§executable: OsString

The executable

§clargs: Vec<OsString>

The command line args for the executable

§env: HashMap<String, String>

The environment variables for the executable.

§Warning

ONLY the environment variables in this map will be passed to the executable.

§input: Input

The input to the program, if needed

§output: Output

Where the program’s stdout is emitted

§output_err: Output

Where the program’s stderr is emitted

Implementations§

Source§

impl ExecSpec

Source

pub fn working_dir(&self) -> &Path

The working directory of the exec spec. If the path is relative, then the relative path is calculated relative to the the base directory of a project.

Source

pub fn executable(&self) -> &OsStr

The executable to run

Source

pub fn args(&self) -> &[OsString]

Command line args for the exec spec

Source

pub fn env(&self) -> &HashMap<String, String>

The environment variables for the exec spec

Source

pub fn execute_spec<P>(self, path: P) -> ProjectResult<ExecHandle>
where P: AsRef<Path>,

Try to executes an exec-spec, using the given path to resolve the current directory. If creating the program is successful, returns an ExecSpecHandle. This is a non-blocking method, as the actual command is ran in a separate thread.

Execution of the spec begins as soon as this method is called. However, all scheduling is controlled by the OS.

§Error

This method will return an error if the given path can not be canonicalized into an absolute path, or the executable specified by this spec does not exist.

Source

pub fn finish(&mut self) -> Result<ExitStatus>

👎Deprecated

Waits for the running child process to finish. Will return Some(exit_status) only if a child process has already been started. Otherwise, a None result will be given

Trait Implementations§

Source§

impl Clone for ExecSpec

Source§

fn clone(&self) -> ExecSpec

Returns a duplicate of the value. Read more
1.0.0 · Source§

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ExecSpec

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for ExecSpec

Source§

fn default() -> ExecSpec

Returns the “default value” for a type. Read more
Source§

impl VisitProject<Result<(), Error>> for ExecSpec

Source§

fn visit(&mut self, project: &Project) -> Result<(), Error>

Executes the exec spec in the project.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> InstanceOf for T
where T: Any + ?Sized,

Source§

fn instance_of<T>(&self) -> bool
where T: Any + ?Sized,

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> IntoNamed for T

Source§

fn named<S>(self, name: S) -> Named<Self>
where S: AsRef<str>,

Add a name to this object
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<E> Extension for E
where E: 'static + Send + Sync,