Skip to main content

mytheclipse_queue/
lib.rs

1//! # mytheclipse-queue
2//!
3//! A job queue abstraction so your background work isn't locked to one
4//! transport. Provides a single [`Queue`] trait, [`Job`] type, and `WorkerPool`
5//! executor with configurable retry/backoff, concurrency, and a dead-letter
6//! queue.
7//!
8//! The backend that ships is in-memory (`InMemoryQueue`, feature `in-memory`):
9//! one `Mutex<Vec<Job>>` + `Notify` per topic, no external service. `Queue` is a
10//! trait, so another transport can implement it without touching `WorkerPool`.
11
12pub mod error;
13#[cfg(feature = "in-memory")]
14mod host;
15#[cfg(feature = "in-memory")]
16pub mod in_memory;
17pub mod job;
18pub mod traits;
19#[cfg(feature = "in-memory")]
20pub mod worker;
21
22pub use error::{JobError, QueueError};
23#[cfg(feature = "in-memory")]
24pub use in_memory::InMemoryQueue;
25pub use job::{Job, JobId};
26pub use traits::Queue;
27#[cfg(feature = "in-memory")]
28pub use worker::{JobFuture, JobHandler, WorkerConfig, WorkerPool};
29
30#[cfg(feature = "in-memory")]
31pub mod backpressure_enqueue;
32#[cfg(feature = "in-memory")]
33pub mod batch;
34#[cfg(feature = "in-memory")]
35pub mod rate_limited;
36#[cfg(feature = "in-memory")]
37pub mod worker_rate_limited;
38#[cfg(feature = "in-memory")]
39pub use backpressure_enqueue::{
40    enqueue_with_backpressure, BackpressureEnforcer, BackpressureError,
41};
42#[cfg(feature = "in-memory")]
43pub use rate_limited::{RateLimitQueueError, RateLimitedQueue};
44#[cfg(feature = "in-memory")]
45pub use worker_rate_limited::RateLimitedWorkerPool;
46
47#[cfg(feature = "in-memory")]
48pub mod pipeline;
49#[cfg(feature = "in-memory")]
50pub use pipeline::{Stage, StageError, StageRunner};