1use std::sync::atomic::{AtomicU64, Ordering};
6use std::sync::OnceLock;
7use std::time::{Duration, SystemTime};
8
9#[derive(Debug, Clone, PartialEq, Eq, Hash)]
11pub struct JobId(pub String);
12
13impl JobId {
14 pub fn generate() -> Self {
22 static PREFIX: OnceLock<String> = OnceLock::new();
23 static COUNTER: AtomicU64 = AtomicU64::new(0);
24
25 let prefix = PREFIX.get_or_init(|| {
26 let nanos = SystemTime::now()
27 .duration_since(SystemTime::UNIX_EPOCH)
28 .unwrap_or_default()
29 .as_nanos() as u64;
30 let mut prefix = String::with_capacity(32);
31 push_hex(&mut prefix, nanos);
32 push_hex(&mut prefix, u64::from(std::process::id()));
33 prefix
34 });
35 let sequence = COUNTER.fetch_add(1, Ordering::Relaxed);
36
37 let mut id = String::with_capacity(prefix.len() + 17);
41 id.push_str(prefix);
42 id.push('-');
43 push_hex(&mut id, sequence);
44 Self(id)
45 }
46}
47
48fn push_hex(out: &mut String, value: u64) {
51 const DIGITS: &[u8; 16] = b"0123456789abcdef";
52
53 let mut buf = [0u8; 16];
54 let mut cursor = buf.len();
55 let mut rest = value;
56 loop {
57 cursor -= 1;
58 buf[cursor] = DIGITS[(rest & 0xf) as usize];
59 rest >>= 4;
60 if rest == 0 {
61 break;
62 }
63 }
64 out.push_str(std::str::from_utf8(&buf[cursor..]).expect("hex digits are ASCII"));
65}
66
67impl std::fmt::Display for JobId {
68 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
69 write!(f, "{}", self.0)
70 }
71}
72
73#[derive(Debug, Clone)]
75pub struct Job {
76 pub id: JobId,
78 pub topic: String,
80 pub payload: Vec<u8>,
82 pub attempt: u32,
84 pub enqueued_at: SystemTime,
86 pub delivered_at: Option<SystemTime>,
88 pub visibility_timeout: Option<Duration>,
90}
91
92impl Job {
93 pub fn new(id: JobId, topic: &str, payload: Vec<u8>) -> Self {
94 let now = SystemTime::now();
97 Self {
98 id,
99 topic: topic.to_string(),
100 payload,
101 attempt: 0,
102 enqueued_at: now,
103 delivered_at: Some(now),
104 visibility_timeout: None,
105 }
106 }
107}
108
109#[cfg(test)]
110mod tests {
111 use super::*;
112
113 #[test]
114 fn generated_ids_are_unique() {
115 let a = JobId::generate();
116 let b = JobId::generate();
117 assert_ne!(a, b);
118 }
119
120 #[test]
121 fn generated_ids_share_the_process_prefix() {
122 let a = JobId::generate().0;
123 let b = JobId::generate().0;
124 let prefix = |s: &str| s.rsplit_once('-').unwrap().0.to_owned();
125 assert_eq!(prefix(&a), prefix(&b));
126 }
127}