Struct LocalExecutor 

pub struct LocalExecutor { /* private fields */ }

Reference ToolExecutor for local editing mode: local filesystem + process table. Cheap to construct, stateless apart from the repository context path, safe to share as Arc<dyn ToolExecutor>.

Implementations

impl LocalExecutor

pub fn new() -> Self

Local executor rooted at the process working directory.

pub fn with_cwd(cwd: impl Into<PathBuf>) -> Self

Local executor rooted at cwd (base for relative paths and git calls).

pub fn cwd(&self) -> &Path

The repository context this executor resolves relative paths and git invocations against.

Trait Implementations

impl Clone for LocalExecutor

fn clone(&self) -> LocalExecutor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalExecutor

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

Formats the value using the given formatter.

impl Default for LocalExecutor

fn default() -> Self

Returns the “default value” for a type.

impl ToolExecutor for LocalExecutor

fn kind<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ExecutorKind> + Send + 'async_trait>>

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

Reports which execution environment this executor dispatches to, so callers can distinguish local from sandbox execution.

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

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

Reads a file’s content as UTF-8 text.

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

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

Writes content to path (creating or truncating the file).

fn run_command<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, cwd: &'life1 Path, argv: &'life2 [String], timeout: Duration, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput>> + Send + 'async_trait>>

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

Runs a command with working directory cwd, argument vector argv and a wall-clock timeout; returns the captured output.

fn list_dir<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 Path, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>>> + Send + 'async_trait>>

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

Lists directory entries at path, returning entry names.

fn grep<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, pattern: &'life1 str, path: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>>> + Send + 'async_trait>>

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

Searches for regex pattern under path, returning matching lines.

fn find<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, glob: &'life1 str, path: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>>> + Send + 'async_trait>>

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

Finds files matching glob under path, returning matching paths.

fn git<'life0, 'life1, 'async_trait>( &'life0 self, args: &'life1 [String], ) -> Pin<Box<dyn Future<Output = Result<CommandOutput>> + Send + 'async_trait>>

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

Runs a git invocation with args in the repository context of the executor.