rs-zero 0.2.6

Rust-first microservice framework inspired by go-zero engineering practices
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

/// Number of slots in a Redis Cluster.
pub const REDIS_CLUSTER_SLOTS: u16 = 16_384;

/// Returns the Redis Cluster hash tag used for slot calculation.
///
/// Redis only uses a hash tag when the first `{` is followed by a non-empty
/// substring before `}`. Otherwise the full key is hashed.
pub fn redis_cluster_hash_tag(key: &str) -> &str {
    let Some(start) = key.find('{') else {
        return key;
    };
    let rest = &key[start + 1..];
    let Some(end) = rest.find('}') else {
        return key;
    };
    if end == 0 { key } else { &rest[..end] }
}

/// Calculates the Redis Cluster slot for a key.
pub fn redis_cluster_slot(key: &str) -> u16 {
    crc16(redis_cluster_hash_tag(key).as_bytes()) % REDIS_CLUSTER_SLOTS
}

fn crc16(bytes: &[u8]) -> u16 {
    let mut crc = 0u16;
    for byte in bytes {
        crc ^= (*byte as u16) << 8;
        for _ in 0..8 {
            if crc & 0x8000 != 0 {
                crc = (crc << 1) ^ 0x1021;
            } else {
                crc <<= 1;
            }
        }
    }
    crc
}

#[cfg(test)]
mod tests {
    use super::{redis_cluster_hash_tag, redis_cluster_slot};

    #[test]
    fn slot_matches_redis_examples() {
        assert_eq!(redis_cluster_slot("123456789"), 12739);
        assert_eq!(redis_cluster_slot("{user1000}.following"), 3443);
        assert_eq!(redis_cluster_slot("{user1000}.followers"), 3443);
    }

    #[test]
    fn hash_tag_requires_non_empty_tag() {
        assert_eq!(redis_cluster_hash_tag("foo{}{bar}"), "foo{}{bar}");
        assert_eq!(redis_cluster_hash_tag("foo{bar}zap"), "bar");
    }
}