camel-component-exec 0.23.0

Fail-closed system command execution component for rust-camel
Documentation 
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

//! ExecError — typed errors for the exec component.
//!
//! Pre/during-spawn failures (no output to carry) are `Err`. Post-spawn
//! conditions with output (timeout, exit-code mismatch) are NON-error outcomes
//! (producer returns Ok with result + headers). See spec §Error handling.

/// Errors raised by the exec producer. All surface as
/// `CamelError::ProcessorErrorWithSource(msg, Arc<ExecError>)`.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum ExecError {
    #[error("executable/profile not allowlisted (fail-closed): {requested:?}")]
    NotAllowlisted { requested: String },

    #[error("arg policy denied {arg:?}: {reason}")]
    ArgPolicyDenied { arg: String, reason: String },

    #[error("shell executable rejected without allow_shell: {executable:?}")]
    ShellRejected { executable: String },

    #[error("working dir escapes workspace root: {path:?}")]
    InvalidWorkDir { path: String },

    #[error("stdin exceeds cap ({size} > {max} bytes)")]
    StdinTooLarge { size: usize, max: usize },

    #[error("malformed CamelExecArgs header: {0}")]
    InvalidArgs(String),

    #[error("spawn failed: {0}")]
    Spawn(#[from] std::io::Error),
}