Struct LocalSessionEnv 

pub struct LocalSessionEnv { /* private fields */ }

A SessionEnv backed by a real local directory.

Implementations

impl LocalSessionEnv

pub async fn new( root: impl Into<PathBuf>, limits: Limits, ) -> RuntimeResult<Self>

Create an env rooted at root. The directory is canonicalized; if it does not exist it is created. An fd is held over the canonical root for the lifetime of the env.

Trait Implementations

impl SessionEnv for LocalSessionEnv

fn read_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, max_lines: usize, max_bytes: usize, ) -> Pin<Box<dyn Future<Output = RuntimeResult<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read a file, bounded by max_lines / max_bytes.

fn read_file_full<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, max_bytes: usize, ) -> Pin<Box<dyn Future<Output = RuntimeResult<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read a file in full, erroring (NOT truncating) if it exceeds max_bytes.

fn write_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, path: &'life1 Path, content: &'life2 str, ) -> Pin<Box<dyn Future<Output = RuntimeResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Write a file, creating parent directories as needed.

fn exec<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, command: &'life1 str, cwd: &'life2 Path, timeout_ms: Option<u64>, cancel: &'life3 CancellationToken, ) -> Pin<Box<dyn Future<Output = RuntimeResult<ShellResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Run a shell command, with a timeout_ms hint and cancellation.

fn glob<'life0, 'life1, 'async_trait>( &'life0 self, pattern: &'life1 str, limit: usize, ) -> Pin<Box<dyn Future<Output = RuntimeResult<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List files matching a glob (bounded by limit).

fn grep<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, pattern: &'life1 str, paths: &'life2 [&'life3 str], max_matches: usize, ) -> Pin<Box<dyn Future<Output = RuntimeResult<Vec<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Grep for pattern, bounded by max_matches.