Struct ApprovedRoot 

pub struct ApprovedRoot { /* private fields */ }

An existing directory approved as the boundary for artifact writes.

Implementations

impl ApprovedRoot

pub fn existing(path: impl AsRef<Path>) -> Result<Self, ArtifactPathError>

Approve an existing, non-symlink directory and retain its canonical path.

pub fn path(&self) -> &Path

Return the canonical approved root.

pub fn project_dir( &self, relative: impl AsRef<Path>, ) -> Result<PathBuf, ArtifactPathError>

Resolve a relative directory beneath this root without creating it.

Existing components must be real directories, never symbolic links. Once a missing component is reached there cannot be a deeper existing component, so the remaining validated path can be projected safely.

pub fn prepare_dir( &self, relative: impl AsRef<Path>, ) -> Result<PathBuf, ArtifactPathError>

Prepare a relative directory, rejecting traversal and symlink components.

pub fn prepare_file( &self, relative: impl AsRef<Path>, ) -> Result<PathBuf, ArtifactPathError>

Prepare a relative file’s parent directories and validate its destination.

This does not create or truncate the file. An existing destination must be a regular file and must not be a symlink.

Trait Implementations

impl Clone for ApprovedRoot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ApprovedRoot

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

Formats the value using the given formatter.

impl Eq for ApprovedRoot

impl PartialEq for ApprovedRoot

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ApprovedRoot