Struct TaildropStore 

pub struct TaildropStore { /* private fields */ }

A Taildrop file store rooted at a fixed directory. All operations are confined to this root by joining only validate_base_name-validated names.

Implementations

impl TaildropStore

pub fn new(root: impl Into<PathBuf>) -> Result<Self, TaildropError>

Create a store rooted at root, creating the directory (and parents) if needed.

pub async fn put_file<R>( &self, name: &str, reader: R, offset: u64, ) -> Result<u64, TaildropError>

where R: AsyncRead + Unpin,

Receive a file named name from reader, writing to <name>.partial then atomically renaming to a non-clobbering final name on success. Mirrors Go manager.PutFile.

offset lets a resumed transfer append past already-written bytes (the partial is opened and the write starts at offset). Returns the total number of bytes in the completed file.

Fail-closed: an invalid name is rejected before any path is built; an in-progress partial for the same name yields TaildropError::FileExists; an I/O error mid-transfer leaves the .partial in place (for resume) and the final name is never created.

pub fn waiting_files(&self) -> Result<Vec<WaitingFile>, TaildropError>

List fully-received (non-partial) files, sorted by name (Go WaitingFiles).

pub fn delete_file(&self, name: &str) -> Result<(), TaildropError>

Delete a fully-received file by base name (Go DeleteFile). The name is validated first, so a traversal attempt can never escape the store root.

pub fn open_file(&self, name: &str) -> Result<(File, u64), TaildropError>

Open a fully-received file by base name for reading, returning the handle and its size (Go OpenFile). The name is validated first.

Trait Implementations

impl Clone for TaildropStore

fn clone(&self) -> TaildropStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaildropStore

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

Formats the value using the given formatter.