Struct FileStateStore 

pub struct FileStateStore { /* private fields */ }

A file-backed StateStore: one JSON checkpoint file per download key, under a directory. A crashed download resumes by re-reading its checkpoint. The filename is a fixed-width SHA-256 DIGEST of the key, so it is both filesystem-safe and bounded in length whatever the key is.

Implementations

impl FileStateStore

pub fn new(dir: impl Into<PathBuf>) -> Self

A file state store writing checkpoints under dir (created on first save if missing).

Trait Implementations

impl Clone for FileStateStore

fn clone(&self) -> FileStateStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileStateStore

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

Formats the value using the given formatter.

impl StateStore for FileStateStore

fn load<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<DownloadState>, DownloadError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load the persisted state for key, or None if there is no checkpoint yet.

fn save<'life0, 'life1, 'async_trait>( &'life0 self, state: &'life1 DownloadState, ) -> Pin<Box<dyn Future<Output = Result<(), DownloadError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Persist state (overwriting any prior checkpoint for its key).

fn clear<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), DownloadError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete the checkpoint for key (called after a successful, finalized download).

fn record_bad_descriptor<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, target_key: &'life1 str, peer_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), DownloadError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Remember that peer_id supplied a descriptor for target_key that failed a final integrity gate, so a later call — or a later PROCESS — does not pay for the same lie again.

fn bad_descriptor_peers<'life0, 'life1, 'async_trait>( &'life0 self, target_key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>, DownloadError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

The peers with a still-live record_bad_descriptor verdict for target_key. The default returns none (this store keeps no reputation).