Struct ExecSpec 

#[non_exhaustive]
pub struct ExecSpec {
    pub cmd: Option<Vec<String>>,
    pub cmd_shell: Option<String>,
    pub shell: bool,
    pub cwd: Option<String>,
    pub env: Option<BTreeMap<String, String>>,
    pub on_fail: ExecOnFail,
}

- exec: { ... } — shell-escape hatch.

The cmd XOR cmd_shell invariant is enforced in the custom deserializer. shell=false (default) requires cmd; shell=true requires cmd_shell.

Marked #[non_exhaustive] so spec growth (timeout, stdout capture, sandboxing flags) is non-breaking for library consumers.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

cmd: Option<Vec<String>>

Argv form. Populated when shell=false.

cmd_shell: Option<String>

Single-string shell form. Populated when shell=true.

shell: bool

Whether to parse through sh -c / cmd /c.

cwd: Option<String>

Working directory. Defaults to pack workdir at execute time.

env: Option<BTreeMap<String, String>>

Extra environment variables for this invocation.

on_fail: ExecOnFail

Error-propagation policy.

Implementations

impl ExecSpec

pub fn new( cmd: Option<Vec<String>>, cmd_shell: Option<String>, shell: bool, cwd: Option<String>, env: Option<BTreeMap<String, String>>, on_fail: ExecOnFail, ) -> Self

Construct an ExecSpec with all current fields in canonical order.

Trait Implementations

impl Clone for ExecSpec

fn clone(&self) -> ExecSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecSpec

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

Formats the value using the given formatter.

impl PartialEq for ExecSpec

fn eq(&self, other: &ExecSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ExecSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ExecSpec

impl StructuralPartialEq for ExecSpec