Skip to main content

Crate asyncq_redis

Crate asyncq_redis 

Source
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 fields

Structs§

RedisBackend
Redis backend for asyncq.