Struct RunScope 

pub struct RunScope {
    pub vars: BTreeMap<String, String>,
    pub contract_version: Option<String>,
    pub skip_if_fingerprint_match: bool,
    pub write_receipt: bool,
    pub run_id: Option<String>,
}

Variables and policy for one pipeline invocation (CLI / library / orchestrator).

Fields

vars: BTreeMap<String, String>

Free-form and partition binds (report_date, run_id, domain, …).

contract_version: Option<String>

Optional contract version stamped into fingerprints / receipts. Overrides rbt_project.yml contract_version when set.

skip_if_fingerprint_match: bool

When true, skip materialize if bronze fingerprint matches last successful receipt.

write_receipt: bool

Write .rbt/runs/{run_id}.json receipt after run (default true for CLI run).

run_id: Option<String>

Explicit run id; generated when empty.

Implementations

impl RunScope

pub fn new() -> Self

pub fn with_var(self, key: impl Into<String>, value: impl Into<String>) -> Self

pub fn extend_from_kv_pairs<'a, I>(&mut self, pairs: I) -> Result<()>

where I: IntoIterator<Item = &'a str>,

Parse repeated key=value tokens (CLI --var).

pub fn extend_from_env(&mut self)

Load RBT_VAR_<KEY> env vars (e.g. RBT_VAR_REPORT_DATE=2026-07-29 → report_date).

pub fn expand_template(&self, input: &str) -> String

Expand {name} and ${name} using run vars (not project $roots).

pub fn effective_require_partitions( &self, partition_by: &[String], frontmatter: &HashMap<String, String>, ) -> HashMap<String, String>

Merge frontmatter require_partitions with run vars for keys in partition_by.

Run vars win over static frontmatter values for the same key. Values are template-expanded.

pub fn scope_key(&self) -> String

Stable short key for receipts scoped by vars (not including run_id).

pub fn resolve_run_id(&self) -> String

Trait Implementations

impl Clone for RunScope

fn clone(&self) -> RunScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunScope

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

Formats the value using the given formatter.

impl Default for RunScope

fn default() -> RunScope

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RunScope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RunScope

impl PartialEq for RunScope

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RunScope

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 RunScope