Enum SubprocessMode 

#[non_exhaustive]
pub enum SubprocessMode {
    Command {
        command: String,
        args: Vec<String>,
    },
    Script {
        interpreter: String,
        body: String,
        args: Vec<String>,
    },
}

Execution strategy for a subprocess task.

Variant	Fields
Command	executable and arguments
Script	interpreter, base64 body, arguments

Example

use base64::Engine;
use base64::engine::general_purpose::STANDARD as BASE64;
use solti_model::SubprocessMode;

let mode = SubprocessMode::Script {
    interpreter: "bash".into(),
    body: BASE64.encode("echo hello"),
    args: vec![],
};

assert_eq!(mode.decode_body().unwrap(), "echo hello");

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Command

Direct binary execution.

Fields

command: String

Executable name or path.

args: Vec<String>

Command-line arguments.

Script

Script execution via an explicit interpreter.

Fields

interpreter: String

Interpreter executable name or path.

body: String

Standard padded base64 script body.

args: Vec<String>

Additional arguments passed after the script body.

Implementations

impl SubprocessMode

pub fn decode_body(&self) -> ModelResult<String>

Decodes the script body as UTF-8.

Uses MAX_SCRIPT_BODY_BYTES as the decoded size limit.

Errors

Returns ModelError::Invalid for command mode, invalid base64, non-UTF-8 data, an empty body, or an oversized body.

Example

use base64::Engine;
use base64::engine::general_purpose::STANDARD as BASE64;
use solti_model::SubprocessMode;

let mode = SubprocessMode::Script {
    interpreter: "bash".into(),
    body: BASE64.encode("echo hello"),
    args: vec![],
};

assert_eq!(mode.decode_body().unwrap(), "echo hello");

pub fn decode_body_with_limit(&self, max_bytes: usize) -> ModelResult<String>

Decodes the script body with a custom size limit.

Encoded size is checked before allocation.

Errors

Returns ModelError::Invalid for command mode, invalid base64, non-UTF-8 data, an empty body, or a body larger than max_bytes.

Example

use base64::Engine;
use base64::engine::general_purpose::STANDARD as BASE64;
use solti_model::SubprocessMode;

let mode = SubprocessMode::Script {
    interpreter: "bash".into(),
    body: BASE64.encode("echo hello"),
    args: vec![],
};

assert!(mode.decode_body_with_limit(4).is_err());

pub fn validate(&self) -> ModelResult<()>

Validates the subprocess mode.

Errors

Returns ModelError::Invalid for an empty command or interpreter, or for an invalid, non-UTF-8, or oversized script body.

Example

use solti_model::SubprocessMode;

let mode = SubprocessMode::Command {
    command: "echo".into(),
    args: vec!["hello".into()],
};

mode.validate().unwrap();

Trait Implementations

impl Clone for SubprocessMode

fn clone(&self) -> SubprocessMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubprocessMode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SubprocessMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SubprocessMode

impl JsonSchema for SubprocessMode

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for SubprocessMode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SubprocessMode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SubprocessMode