Struct ClientPath 

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

A non-empty, NUL-free path supplied by an MCP client.

The path may be relative or contain ./..; whether it lies inside the workspace is decided later by WorkspaceRoots::validate. The MCP tool methods parse their file_path into a ClientPath first thing (not while deserializing the parameters, which rmcp reports as a tool-result error rather than a JSON-RPC error), so a malformed path is -32602.

Examples

use std::path::PathBuf;

use mcpls_core::bridge::{ClientPath, InvalidClientPath};

let path = ClientPath::try_from(PathBuf::from("/ws/src/main.rs"))?;
assert_eq!(path.as_path(), std::path::Path::new("/ws/src/main.rs"));
assert_eq!(
    ClientPath::try_from(PathBuf::new()),
    Err(InvalidClientPath::Empty)
);

Implementations

impl ClientPath

pub fn as_path(&self) -> &Path

The validated path.

Trait Implementations

impl Clone for ClientPath

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 ClientPath

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

Formats the value using the given formatter.

impl Eq for ClientPath

impl Hash for ClientPath

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 ClientPath

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ClientPath

impl TryFrom<PathBuf> for ClientPath

type Error = InvalidClientPath

The type returned in the event of a conversion error.

fn try_from(path: PathBuf) -> Result<Self, Self::Error>

Performs the conversion.