rs-zero 0.2.8

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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

#![cfg(feature = "cache-redis")]

use std::time::{Duration, SystemTime, UNIX_EPOCH};

use rs_zero::{
    cache_redis::{RedisBreakerConfig, RedisCacheConfig},
    lock::{DistributedLock, LockError, RedisDistributedLock, RedisLockConfig},
};

#[tokio::test]
#[ignore = "requires RS_ZERO_TEST_REDIS_URL pointing to a running Redis instance"]
async fn redis_lock_acquire_contention_release_and_ttl_expiry() {
    let url = std::env::var("RS_ZERO_TEST_REDIS_URL")
        .unwrap_or_else(|_| "redis://127.0.0.1:6379".to_string());
    let lock = RedisDistributedLock::new(RedisLockConfig {
        redis: RedisCacheConfig {
            url,
            ..RedisCacheConfig::default()
        },
        namespace: format!("rs-zero-lock-{}", unique_suffix()),
        breaker: RedisBreakerConfig::go_zero_defaults(),
        ..RedisLockConfig::default()
    })
    .expect("lock backend");

    lock.health_check().await.expect("redis health");

    let key = "order:{external-lock}";
    let first = lock
        .try_acquire(key, Duration::from_millis(250))
        .await
        .expect("first acquire");
    assert!(
        lock.acquire(key, Duration::from_millis(250))
            .await
            .expect("second acquire returns busy")
            .is_none()
    );

    let stale_guard = first.clone();
    lock.release(&first).await.expect("release owner");
    assert!(
        matches!(
            lock.release(&stale_guard)
                .await
                .expect_err("second release mismatches"),
            LockError::OwnerMismatch
        ),
        "second release must not delete another owner's lock"
    );

    let expiring = lock
        .try_acquire(key, Duration::from_millis(100))
        .await
        .expect("expiring acquire");
    tokio::time::sleep(Duration::from_millis(180)).await;
    let reacquired = lock
        .try_acquire(key, Duration::from_millis(250))
        .await
        .expect("reacquire after ttl");
    assert!(matches!(
        lock.release(&expiring)
            .await
            .expect_err("expired owner mismatch"),
        LockError::OwnerMismatch
    ));
    lock.release(&reacquired).await.expect("release reacquired");
}

fn unique_suffix() -> String {
    let nanos = SystemTime::now()
        .duration_since(UNIX_EPOCH)
        .unwrap_or_default()
        .as_nanos();
    format!("{nanos}-{}", std::process::id())
}