Struct ExecutionScope 

pub struct ExecutionScope { /* private fields */ }

One created or reopened study-execution directory.

Implementations

impl ExecutionScope

pub fn open_or_create( recording_root: impl AsRef<Path>, ) -> Result<Self, ExecutionScopeError>

Uses the recording root itself as the deterministic execution scope.

This is intended for application-owned semantic task names where a repeated configuration must resolve to the same output path instead of receiving a timestamped execution wrapper.

pub fn create_generated( recording_root: impl AsRef<Path>, ) -> Result<Self, ExecutionScopeError>

Creates a uniquely named scope beneath recording_root.

The readable UTC component is supplemented by process and sequence values. Exclusive directory creation remains the final collision check.

pub fn create_named( recording_root: impl AsRef<Path>, name: impl Into<String>, ) -> Result<Self, ExecutionScopeError>

Creates one caller-named scope beneath recording_root.

pub fn open_existing( directory: impl Into<PathBuf>, ) -> Result<Self, ExecutionScopeError>

Opens an existing execution scope without creating or modifying files.

pub fn directory(&self) -> &Path

Returns the scope directory.

pub fn created_at_utc(&self) -> Option<&str>

Returns the automatically captured creation timestamp when this handle created the scope.

Reopened legacy scopes return None because no auxiliary scope metadata is invented merely to recover a timestamp.

pub fn task_recording_directory(&self, ordinal: u64) -> PathBuf

Derives the absent recording path reserved for one deterministic task.

The directory is deliberately not created: the recording writer must retain exclusive creation and overwrite protection.

pub fn named_task_recording_directory( &self, name: &str, ) -> Result<PathBuf, ExecutionScopeError>

Derives the absent recording path reserved for one semantic relative path.

Trait Implementations

impl Clone for ExecutionScope

fn clone(&self) -> ExecutionScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecutionScope

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

Formats the value using the given formatter.

impl Eq for ExecutionScope

impl PartialEq for ExecutionScope

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ExecutionScope