menuTicketing

Bibliothèque Rust Ticketing

GitHub

Dépôt

Exemple

Exemple de base

Il s'agit d'une API asynchrone basée sur Tokio. On se connecte à un seul serveur, on acquiert une clé, puis on la libère immédiatement.

rust
use std::time::Duration;
use ticketing::TicketBroker;

let broker = TicketBroker::connect(["127.0.0.1:5225"]);
broker.wait_ready(Duration::from_secs(5)).await;

let wait = Duration::from_secs(5);
let lease = Duration::from_secs(30);

let ticket = broker.acquire("key", wait, lease).await.unwrap();
ticket.release().await.unwrap();

println!("pass");

Exemple de concurrence (verrou distribué)

Cet exemple vérifie que, même lorsque plusieurs tâches répètent des dépôts/retraits en s'excluant mutuellement via un verrou par compte, le solde revient toujours à sa valeur initiale. TicketBroker est Clone, ce qui permet de le partager entre plusieurs tâches.

rust
async fn transaction(broker: &TicketBroker, account: usize, delta: i64) {
    let key = format!("account-{account}");

    let _ticket = match broker.acquire(&key, WAIT, LEASE).await {
        Ok(ticket) => Some(ticket),
        Err(e) => {
            tracing::error!("account {account} acquire failed: {e}");
            return;
        }
    };

    // Section critique sécurisée seulement pendant la détention du verrouillage
    let before = balances[account];
    tokio::task::yield_now().await;
    balances[account] = before + delta;

    // Dropping the ticket automatically releases it in the background (not needed if immediate release is not required)
    let (action, sign) = if delta < 0 { ("withdraw", '-') } else { ("deposit", '+') };
    tracing::info!("account {account} {action} {sign}${AMOUNT} -> ${}", balances[account]);
}

Vous trouverez l'exemple complet dans tests/example_simple.rs, tests/example_bank.rs, tests/bench_test.rs.