Expand description
Redis backend for asyncq.
§Quick start
use asyncq::{Queue, Worker, Job, Perform, JobContext, JobResult};
use asyncq_redis::RedisBackend;
use serde::{Serialize, Deserialize};
#[derive(Job, Serialize, Deserialize)]
#[job(queue = "emails", retries = 3)]
struct SendEmail { to: String }
impl Perform for SendEmail {
async fn perform(self, _ctx: JobContext) -> JobResult {
println!("Sending to {}", self.to);
Ok(())
}
}
#[tokio::main]
async fn main() {
let backend = RedisBackend::new("redis://127.0.0.1/").await.unwrap();
let queue = Queue::new(backend);
queue.enqueue(SendEmail { to: "user@example.com".into() }).await.unwrap();
Worker::new(queue).register::<SendEmail>().run().await;
}§Redis key layout
asyncq:q:{queue}:pending LIST job_ids (LPUSH enqueue, BRPOP claim)
asyncq:q:{queue}:delayed ZSET job_id → run_at_unix (scheduled jobs)
asyncq:q:{queue}:dead ZSET job_id → failed_at_unix
asyncq:q:{queue}:completed INTEGER lifetime count of successfully acked jobs
asyncq:processing ZSET job_id → last_heartbeat_unix
asyncq:jobs:{job_id} HASH all job fieldsStructs§
- Redis
Backend - Redis backend for asyncq.