Struct RelativePath 

pub struct RelativePath(/* private fields */);

A configured plugin-relative path: begins with ./ and, resolved purely lexically, never leaves the plugin root (§4.1).

This is the type for values a plugin author wrote — an MCP command of ./bin/server, a cwd of ./data. Successful parsing is the containment proof; APIs that need a safe path ask for a RelativePath, not a string.

Lexical containment is necessary but not sufficient: symlinks can still escape at the filesystem level, which is why loading also asks its IO source whether the resolved path stays confined (§4.1 rule 3).

Implementations

impl RelativePath

pub fn parse(raw: &str) -> Result<Self, RelativePathError>

Parse a configured value as a plugin-relative path.

pub fn as_str(&self) -> &str

The path exactly as written, including the leading ./.

pub fn resolve(&self, plugin_root: &Path) -> PathBuf

Resolve against a native plugin root.

Trait Implementations

impl Clone for RelativePath

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 RelativePath

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

Formats the value using the given formatter.

impl Display for RelativePath

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

Formats the value using the given formatter.

impl Eq for RelativePath

impl FromStr for RelativePath

type Err = RelativePathError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for RelativePath

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RelativePath

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RelativePath