Struct PathResolutionContext 

pub struct PathResolutionContext { /* private fields */ }

Runtime paths needed to resolve platform-independent policy selectors.

The context is supplied by a harness or a platform backend. Constructing it never reads the filesystem, follows symlinks, or infers a workspace.

Implementations

impl PathResolutionContext

pub fn new() -> Self

Creates an empty context.

pub fn with_root(self, path: impl Into<PathBuf>) -> Result<Self, PolicyError>

Adds one absolute system root represented by the runtime environment.

POSIX backends normally provide /. Windows backends may provide more than one drive or UNC root. The context never discovers these paths on its own.

pub fn with_workspace_root( self, path: impl Into<PathBuf>, ) -> Result<Self, PolicyError>

Adds one absolute workspace root.

pub fn with_minimal_path( self, path: impl Into<PathBuf>, ) -> Result<Self, PolicyError>

Adds one absolute path required by ordinary process execution.

pub fn with_executable_root( self, path: impl Into<PathBuf>, ) -> Result<Self, PolicyError>

Adds one absolute runtime root whose executable files may be mapped by a backend that supports this capability.

This declaration is intentionally separate from readable filesystem roots. Reading a runtime file does not by itself authorize the native loader to map it executable.

pub fn with_tmpdir(self, path: impl Into<PathBuf>) -> Result<Self, PolicyError>

Sets the platform temporary directory.

pub fn with_slash_tmp( self, path: impl Into<PathBuf>, ) -> Result<Self, PolicyError>

Sets the conventional /tmp directory when the platform provides it.

pub fn with_current_directory( self, path: impl Into<PathBuf>, ) -> Result<Self, PolicyError>

Sets the absolute runtime current directory used for command cwd resolution and for commands that otherwise inherit their cwd.

This is runtime input only; the context never reads the directory or changes the process cwd.

pub fn workspace_roots(&self) -> &[PathBuf]

Returns the configured workspace roots.

pub fn root_paths(&self) -> &[PathBuf]

Returns the absolute system roots supplied by the runtime.

pub fn minimal_paths(&self) -> &[PathBuf]

Returns the configured minimal runtime paths.

pub fn executable_roots(&self) -> &[PathBuf]

Returns runtime roots declared for native executable mapping.

pub fn tmpdir(&self) -> Option<&Path>

Returns the configured platform temporary directory.

pub fn slash_tmp(&self) -> Option<&Path>

Returns the configured conventional /tmp directory.

pub fn current_directory(&self) -> Option<&Path>

Returns the absolute runtime directory used for relative command cwd values and for commands that inherit their cwd.

Trait Implementations

impl Clone for PathResolutionContext

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 PathResolutionContext

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

Formats the value using the given formatter.

impl Default for PathResolutionContext

fn default() -> Self

Returns the “default value” for a type.

impl Eq for PathResolutionContext

impl PartialEq for PathResolutionContext

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PathResolutionContext