klirr-core 0.2.1

Zero-maintenance and smart FOSS generating beautiful invoices for services and expenses.
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

use crate::prelude::*;

/// An invoice number timestamp with year and month, e.g. `(237, 2025-05)`.
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Builder, Getters)]
pub struct TimestampedInvoiceNumber<Period: IsPeriod> {
    /// A base offset for the invoice number, e.g. `237`.
    #[getset(get = "pub")]
    offset: InvoiceNumber,

    /// The month and year for when the `offset` was used, e.g. `2025-05`.
    #[getset(get = "pub")]
    period: Period,
}

impl<Period: IsPeriod + HasSample> HasSample for TimestampedInvoiceNumber<Period> {
    fn sample() -> Self {
        Self::builder()
            .offset(InvoiceNumber::from(17u16))
            .period(Period::sample_other())
            .build()
    }

    fn sample_other() -> Self {
        Self::builder()
            .offset(InvoiceNumber::from(42u16))
            .period(Period::sample())
            .build()
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    type Sut = TimestampedInvoiceNumber<YearAndMonth>;

    #[test]
    fn equality() {
        assert_eq!(Sut::sample(), Sut::sample());
        assert_eq!(Sut::sample_other(), Sut::sample_other());
    }

    #[test]
    fn inequality() {
        assert_ne!(Sut::sample(), Sut::sample_other());
    }
}