rustlavel-ledger 0.9.0

A double-entry ledger for credits and balances: atomic debit and credit, holds that capture or release, credits that expire by batch, and a history that adds up
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

//! A reservation against an account.

use rustlavel_core::Json;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum HoldStatus {
    /// Reserved. `available` is down by the amount; `balance` is not.
    Held,
    /// Spent. A `Capture` transfer was written.
    Captured,
    /// Given back. Nothing was written to the history: nothing moved.
    Released,
}

impl HoldStatus {
    pub fn as_str(self) -> &'static str {
        match self {
            HoldStatus::Held => "held",
            HoldStatus::Captured => "captured",
            HoldStatus::Released => "released",
        }
    }

    pub fn parse(text: &str) -> Option<HoldStatus> {
        Some(match text {
            "held" => HoldStatus::Held,
            "captured" => HoldStatus::Captured,
            "released" => HoldStatus::Released,
            _ => return None,
        })
    }
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Hold {
    pub id: String,
    pub account_id: String,
    pub amount: i64,
    pub status: HoldStatus,
    /// What the hold is for — a job id, usually. Unique: holding twice for one
    /// job returns the first hold.
    pub reference: String,
    pub created_at: u64,
    /// After this, [`crate::Ledger::sweep`] releases it. A job that died
    /// without releasing must not keep its credits reserved forever.
    pub expires_at: u64,
}

impl Hold {
    pub fn to_json(&self) -> Json {
        Json::object([
            ("id", Json::from(self.id.as_str())),
            ("account_id", Json::from(self.account_id.as_str())),
            ("amount", Json::from(self.amount)),
            ("status", Json::from(self.status.as_str())),
            ("reference", Json::from(self.reference.as_str())),
            ("created_at", Json::from(self.created_at as i64)),
            ("expires_at", Json::from(self.expires_at as i64)),
        ])
    }
}