Struct RootedWorkspace 

pub struct RootedWorkspace { /* private fields */ }

A real directory, viewed through workspace-relative paths.

Implementations

impl RootedWorkspace

pub fn open(root: impl Into<PathBuf>) -> Result<Self>

Opens root, probing which link primitives this host currently permits.

pub fn with_support(root: impl Into<PathBuf>, support: LinkSupport) -> Self

Opens root with a fixed capability set, for tests that need to exercise a fallback path on a host that would not otherwise take it.

pub fn root(&self) -> &Path

The absolute root of this workspace.

pub fn native(&self, path: &RelPath) -> PathBuf

Translates a workspace-relative path into a native one.

pub fn stale_junctions(&self, candidates: &[RelPath]) -> Vec<(RelPath, String)>

Links whose stored target no longer resolves inside this workspace.

Junctions record an absolute path, so moving or copying a workspace leaves them pointing at the old location — silently, and with the old content still readable. agentlink doctor uses this to catch that case.

Trait Implementations

impl Clone for RootedWorkspace

fn clone(&self) -> RootedWorkspace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RootedWorkspace

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

Formats the value using the given formatter.

impl Workspace for RootedWorkspace

fn probe(&self, path: &RelPath) -> FsResult<Option<Entry>>

Inspects an entry without following a trailing link.

fn read(&self, path: &RelPath) -> FsResult<String>

Reads a UTF-8 file, following links.

fn write(&self, path: &RelPath, contents: &str) -> FsResult<()>

Writes a UTF-8 file, creating parent directories as needed.

fn create_dir_all(&self, path: &RelPath) -> FsResult<()>

Creates a directory and all missing parents.

fn link( &self, via: Via, node: NodeKind, canonical: &RelPath, target: &RelPath, ) -> FsResult<()>

Creates a link at target resolving to canonical, creating target’s parent directories as needed.

fn remove_link(&self, path: &RelPath, node: NodeKind) -> FsResult<()>

Removes a link, never recursing into its contents.

fn remove_file(&self, path: &RelPath) -> FsResult<()>

Removes a regular file.

fn remove_empty_dir(&self, path: &RelPath) -> FsResult<()>

Removes a directory, failing if it is not empty.

fn rename(&self, from: &RelPath, to: &RelPath) -> FsResult<()>

Moves an entry, creating the destination’s parents as needed.

fn is_empty_dir(&self, path: &RelPath) -> FsResult<bool>

Whether path is a directory containing no entries.

fn support(&self) -> LinkSupport

Which link primitives this host currently permits.