Struct RemoteFile 

pub struct RemoteFile { /* private fields */ }

A canonical absolute remote file on one endpoint.

Implementations

impl RemoteFile

pub fn parse(value: &str) -> Result<Self, AddressError>

Admit one canonical file location ssh://[user@]host[:port]/abs/path. A home query (/~/…) is refused: it is not canonical until a session expands it. Pure: no filesystem, no subprocess.

pub fn endpoint(&self) -> &RemoteEndpoint

The endpoint this file lives on — the pooled-session identity.

pub fn path(&self) -> &Path

The decoded remote path. A remote POSIX path, not a local one.

pub fn with_path(&self, path: PathBuf) -> Result<Self, AddressError>

The same endpoint addressing a different absolute native path: navigating a directory entry, a resolved home, a Git target. The path is admitted (absolute, no NUL, natively representable); it is never trimmed or normalized.

pub fn from_path( endpoint: RemoteEndpoint, path: PathBuf, ) -> Result<Self, AddressError>

Shared checked constructor: endpoint + already-native path bytes.

Trait Implementations

impl Clone for RemoteFile

fn clone(&self) -> RemoteFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RemoteFile

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for RemoteFile

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

Formats the value using the given formatter.

impl Eq for RemoteFile

impl From<RemoteFile> for RemoteEndpoint

fn from(file: RemoteFile) -> Self

Converts to this type from the input type.

impl From<RemoteFile> for RemoteLocation

fn from(file: RemoteFile) -> Self

Converts to this type from the input type.

impl Hash for RemoteFile

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 RemoteFile

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RemoteFile

Serde carries the canonical validated URI — one string, re-parsed on the way in, so stored values can never bypass admission.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.