Struct ShellRun 

pub struct ShellRun;

Shell command processor — runs external CLI tools.

Implementations

impl ShellRun

pub fn new() -> Self

Trait Implementations

impl Default for ShellRun

fn default() -> Self

Returns the “default value” for a type.

impl NodeProcessor for ShellRun

fn reserved_tokens(&self) -> &'static [&'static str]

Filled after the executor, by shell-run itself (SEC-27).

fn process( &self, input: NodeInput, progress: &ProgressReporter, ctx: &dyn ProcessContext, ) -> Result<NodeOutput, BntoError>

Run with no incoming files (a direct call, not through the executor).

fn process_batch( &self, input: BatchInput, progress: &ProgressReporter, ctx: &dyn ProcessContext, ) -> Result<NodeOutput, BntoError>

Run once with every incoming file, for each groups in args. The files never reach the command otherwise, and the output is named after the command alone, as when the node had no input.

fn resolves_items(&self) -> bool

Fills {{item.*}} inside each groups itself, once per file.

fn name(&self) -> &str

The processor’s type key (e.g., “image-compress”). Must match the key used in registry.register(). Convention: category-operation, kebab-case.

fn validate(&self, params: &Map<String, Value>) -> Vec<String>

Validate the input parameters before processing.

fn platform_problems( &self, params: &Map<String, Value>, platforms: &[&str], ) -> Vec<String>

Problems the params cause on some of the platforms the step can run on: the values {{ctx.platform}} may read there (macos, linux, windows, unknown), narrowed by the platform guards on its path. bnto check reports them (shell-run’s Windows-only powershell).

fn validate_raw(&self, raw: &Map<String, Value>) -> Vec<String>

Problems in the params as the recipe wrote them, before any template is filled — what validate can’t see once data is in, such as a data placeholder in a param that must be literal. The executor refuses the run on any, before a step starts; bnto check reports them.

fn metadata(&self) -> NodeMetadata

Return the processor’s self-describing metadata.

fn count_keys(&self) -> &'static [&'static str]

Keys of the node-level NodeOutput.metadata that count something per call (e.g. files copied). When the node runs more than once — a per-file node over several files, a loop’s iterations — the executor adds these up in the node’s record instead of keeping the last call’s value.

fn declared_params(&self) -> Option<Vec<ParameterDef>>

The params a run accepts for this node: its metadata’s, or None when the processor keeps the placeholder metadata() above (test mocks), which declares nothing. A run refuses any other param.