Struct LocalFileFlowTaskQueue 

pub struct LocalFileFlowTaskQueue { /* private fields */ }

JSON-backed local durable task queue.

Tasks are stored as one JSON file per pending item under <root>/pending. The queue serializes access inside the current process. It is intended for embedded hosts and local crash/restart durability of pending tasks; it does not provide cross-process locking. Heartbeats atomically rename inflight files, making the replacement file name a new fencing token and lease-age timestamp.

Implementations

impl LocalFileFlowTaskQueue

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

pub fn root(&self) -> &Path

pub async fn inflight_len(&self) -> Result<usize>

pub async fn dead_letter_len(&self) -> Result<usize>

pub async fn dead_lettered_tasks( &self, ) -> Result<Vec<LocalFileDeadLetteredTask>>

pub async fn requeue_inflight_older_than( &self, cutoff: DateTime<Utc>, ) -> Result<usize>

pub async fn dead_letter_inflight_older_than( &self, cutoff: DateTime<Utc>, reason: impl Into<String>, ) -> Result<usize>

Trait Implementations

impl Clone for LocalFileFlowTaskQueue

fn clone(&self) -> LocalFileFlowTaskQueue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalFileFlowTaskQueue

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

Formats the value using the given formatter.

impl FlowTaskQueue for LocalFileFlowTaskQueue

fn enqueue<'life0, 'async_trait>( &'life0 self, task: FlowTask, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

fn lease<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<FlowTaskLease>>> + Send + 'async_trait>>

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

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

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

Refreshes an active lease and returns its replacement fencing token.

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

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

Acknowledges the active lease identified by its latest fencing token.

fn requeue_inflight<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<usize>> + Send + 'async_trait>>

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

fn len<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<usize>> + Send + 'async_trait>>

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

fn dequeue<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<FlowTask>>> + Send + 'async_trait>>

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

fn is_empty<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

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