Skip to main content

mytheclipse_queue/
lib.rs

1//! # mytheclipse-queue
2//!
3//! A unified 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 in-memory backend (`InMemoryQueue`, feature `in-memory`) is the one that
9//! exists today: `tokio::sync::mpsc` plus task spawning, no external service.
10//! The `redis`, `nats`, and `postgres` features are declared but have no backend
11//! implementation yet — see the README.
12
13pub mod error;
14#[cfg(feature = "in-memory")]
15pub mod in_memory;
16pub mod job;
17pub mod traits;
18#[cfg(feature = "in-memory")]
19pub mod worker;
20
21pub use error::{JobError, QueueError};
22#[cfg(feature = "in-memory")]
23pub use in_memory::InMemoryQueue;
24pub use job::{Job, JobId};
25pub use traits::Queue;
26#[cfg(feature = "in-memory")]
27pub use worker::{JobFuture, JobHandler, WorkerConfig, WorkerPool};
28
29#[cfg(feature = "in-memory")]
30pub mod backpressure_enqueue;
31#[cfg(feature = "in-memory")]
32pub mod batch;
33#[cfg(feature = "in-memory")]
34pub mod rate_limited;
35#[cfg(feature = "in-memory")]
36pub mod worker_rate_limited;
37#[cfg(feature = "in-memory")]
38pub use backpressure_enqueue::{
39    enqueue_with_backpressure, BackpressureEnforcer, BackpressureError,
40};
41#[cfg(feature = "in-memory")]
42pub use rate_limited::{RateLimitQueueError, RateLimitedQueue};
43#[cfg(feature = "in-memory")]
44pub use worker_rate_limited::RateLimitedWorkerPool;
45
46#[cfg(feature = "in-memory")]
47pub mod pipeline;
48#[cfg(feature = "in-memory")]
49pub use pipeline::{Stage, StageError, StageRunner};