Struct SftpFs 

pub struct SftpFs { /* private fields */ }

Implementations

impl SftpFs

pub async fn connect(host: &str) -> Result<Self>

pub async fn over<W, R>(w: W, r: R) -> Result<Self>

where W: AsyncWrite + Unpin + Send + 'static, R: AsyncRead + Unpin + Send + 'static,

Drive a session over arbitrary streams. Exists so the round-trip invariant can be asserted against an in-memory server, with no ssh anywhere.

Trait Implementations

impl RemoteFs for SftpFs

async fn read_batch(&self, paths: &[String]) -> Vec<Result<Vec<u8>>>

Read whole files. Implementations must issue every request before awaiting any reply; doing otherwise silently reintroduces O(N) round trips.

async fn read_ranges(&self, reqs: &[RangeReq]) -> Vec<Result<Vec<u8>>>

Read byte ranges. Chunking is the implementation’s business; what matters here is that the whole set is issued together, so a one-megabyte range costs one round trip rather than the thirty-two its chunks would suggest.

async fn home(&self) -> Result<String>

The absolute path a fresh session starts in — the account’s home directory.

async fn append(&self, path: &str, bytes: &[u8]) -> Result<()>

Append bytes to a file, creating it if absent.

async fn mkdirs(&self, path: &str) -> Result<()>

Create a directory and every missing parent.

async fn list_dirs(&self, paths: &[String]) -> Vec<Result<Vec<Entry>>>

List several directories at once. One listing carries every entry’s attrs, which is what removes per-file stat from the page path; batching the listings is what holds a symlink check over a deep path at one round trip rather than one per path component.

fn round_trips(&self) -> u64

Flushes issued so far. One flush is one remote round trip, so this is the invariant made observable, and assertable in tests.

async fn list_dir(&self, path: &str) -> Result<Vec<Entry>>

The n=1 case, defined in terms of the batch so that no implementation can quietly make the single listing the cheap path and the batch a loop.