Struct CorpusRoot 

pub struct CorpusRoot { /* private fields */ }

A canonicalized, read-only corpus root that all paths are jailed to.

Cheaply cloneable; clones share the same root and limits.

Implementations

impl CorpusRoot

pub fn new(path: impl AsRef<Path>) -> Result<Self>

Establish a corpus root at path with Limits::default.

Fails if the path does not exist or is not a directory.

pub fn with_limits(path: impl AsRef<Path>, limits: Limits) -> Result<Self>

Establish a corpus root at path with explicit limits.

pub fn root(&self) -> &Path

The canonicalized root directory.

pub fn limits(&self) -> &Limits

The active resource limits.

pub fn resolve(&self, requested: &str) -> Result<PathBuf>

Resolve a caller-supplied path against the corpus root and verify it stays within the jail.

requested may be relative (resolved against the root) or absolute (which must still land inside the root). The path must exist; symlinks are resolved before the containment check, so a link pointing outside the corpus is rejected.

pub fn relativize<'a>(&self, path: &'a Path) -> Cow<'a, str>

Render a path (assumed inside the root) as a corpus-relative string for display back to the agent. Falls back to the original on failure.

Trait Implementations

impl Clone for CorpusRoot

fn clone(&self) -> CorpusRoot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CorpusRoot

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

Formats the value using the given formatter.