Struct RunnerOptions 

pub struct RunnerOptions {
    pub other: Vec<String>,
    pub define: BTreeMap<String, String>,
}

Runtime variable definitions and additional arguments for a Runner.

Default creates an empty definition map and argument list. The map holds at most one value per name and is forwarded in key order, not insertion order. Values are stored without validating the selected runtime’s naming or value rules.

Examples

use asimov_patterns::RunnerOptions;

let options = RunnerOptions::builder()
    .define("mode", "preview")
    .define("expression", "a=b")
    .build();

assert_eq!(options.define.get("expression").map(String::as_str), Some("a=b"));

Fields

other: Vec<String>

Additional arguments appended after definitions, including an optional program file.

Each string is one literal argument, without shell expansion. To express ordered or repeated --define arguments that the map cannot represent, put them here and leave those keys out of define. The program’s documented duplicate-definition policy then applies. See crate::programs for option and operand ordering.

define: BTreeMap<String, String>

Named runtime values passed as --define=VAR=VAL (-D in the CLI).

The runner emits one argument per entry in BTreeMap key order. The program splits the argument value at its first =: names must be nonempty and cannot contain =, while values may be empty or contain additional = characters. These constraints are not checked here.

Replacing a key in this map replaces its previous value before execution; it does not send duplicate definitions to the program. Definitions are runtime arguments, not environment-variable assignments or shell source.

Implementations

impl RunnerOptions

pub fn builder() -> RunnerOptionsBuilder

Create an instance of RunnerOptions using the builder syntax

Trait Implementations

impl Clone for RunnerOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunnerOptions

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

Formats the value using the given formatter.

impl Default for RunnerOptions

fn default() -> Self

Returns the “default value” for a type.

impl Eq for RunnerOptions

impl Hash for RunnerOptions

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for RunnerOptions

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for RunnerOptions

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for RunnerOptions

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for RunnerOptions