Struct Scenario 

pub struct Scenario {
    pub info: ScenarioInfo,
    pub steps: Vec<ScenarioStep>,
}

Fields

info: ScenarioInfo

steps: Vec<ScenarioStep>

Implementations

impl Scenario

pub const PATH: &'static str = "/home/runner/work/mina-rust/mina-rust/node/testing/res/scenarios"

pub fn new(id: ScenarioId, parent_id: Option<ScenarioId>) -> Self

pub fn set_description(&mut self, description: String)

pub fn add_node(&mut self, config: NodeTestingConfig)

pub fn add_step(&mut self, step: ScenarioStep) -> Result<(), Error>

fn tmp_file_path(&self) -> String

pub fn file_path(&self) -> String

fn file_path_by_id(id: &ScenarioId) -> String

pub fn exists(id: &ScenarioId) -> bool

pub async fn list() -> Result<Vec<ScenarioInfo>, Error>

pub async fn load(id: &ScenarioId) -> Result<Self, Error>

Load a scenario from disk by ID.

This method reads the scenario file from res/scenarios/{id}.json, deserializes it from JSON, and returns the complete scenario including both metadata and steps.

Arguments

• id - The scenario identifier used to construct the file path

Returns

• Ok(Scenario) - Successfully loaded scenario
• Err(anyhow::Error) - File not found, invalid JSON, or I/O error

pub async fn reload(&mut self) -> Result<(), Error>

Reload this scenario from disk, discarding any in-memory changes.

pub async fn save(&self) -> Result<(), Error>

Save the scenario to disk using atomic write operations.

This method implements atomic writes by:

1. Creating the scenarios directory if it doesn’t exist
2. Writing to a temporary file (.tmp.{id}.json)
3. Pretty-printing JSON for human readability
4. Atomically renaming the temp file to the final name

This ensures the scenario file is never in a partially-written state, preventing corruption during concurrent access or system crashes.

File Location

Saves to: {CARGO_MANIFEST_DIR}/res/scenarios/{id}.json

Errors

Returns error if:

• Cannot create the scenarios directory
• Cannot serialize scenario to JSON
• File I/O operations fail
• Atomic rename fails

pub fn save_sync(&self) -> Result<(), Error>

Synchronous version of save() for use in non-async contexts.

Implements the same atomic write pattern as save() but uses blocking I/O operations instead of async.

Trait Implementations

impl Clone for Scenario

fn clone(&self) -> Scenario

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scenario

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Scenario

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Scenario

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

where __S: Serializer,

Serialize this value into the given Serde serializer.