Struct StorageManager 

pub struct StorageManager { /* private fields */ }

Owns the set of declared storage items for a single workflow run and routes operations to the appropriate backend. Built once in [crate::run::execute] and threaded through to every step.

Implementations

impl StorageManager

pub fn build( storage: &HashMap<String, StorageSpec>, backend: FilesystemBackend, ) -> Result<Self, ZigError>

Build a manager from the workflow’s storage table, wiring every entry to a shared FilesystemBackend. Calls ensure on each item so downstream steps can trust that the path is live.

pub fn build_dry( storage: &HashMap<String, StorageSpec>, backend: FilesystemBackend, ) -> Self

Build a manager without calling ensure on its backends.

Used by --dry-run: the <storage> block still renders with the correct absolute paths, but no directories or files are created on disk. The live <contents> listing will reflect whatever happens to be on disk already (or be empty) rather than the state a real run would produce — an acceptable trade-off for a preview.

pub fn empty() -> Self

Empty manager — used when a workflow declares no storage.

pub fn is_empty(&self) -> bool

Returns true when no storage is declared.

pub fn iter(&self) -> impl Iterator<Item = &StorageItem>

Iterate over every declared item, regardless of scoping.

pub fn items_for_step(&self, scope: Option<&[String]>) -> Vec<&StorageItem>

Return the items a step is allowed to see, applying the step’s storage scoping field.

• scope = None (field omitted) → every declared item.
• scope = Some(&[]) → no items.
• scope = Some(names) → only items whose name appears in names.

pub fn render_block( &self, scope: Option<&[String]>, ) -> Result<Option<String>, ZigError>

Render the <storage> XML block for a single step. Returns None when the step is scoped to zero items (or no storage is declared), which tells the caller to omit the block entirely.

pub fn add_dirs_for_step(&self, scope: Option<&[String]>) -> Vec<PathBuf>

Return absolute on-disk paths for every storage folder the step can see. The caller feeds these into the step’s add_dirs so the agent sandbox can actually read/write them.

Trait Implementations

impl Debug for StorageManager

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

Formats the value using the given formatter.