okane-core 0.19.0

Library to support parsing, emitting and processing Ledger (https://www.ledger-cli.org/) format files.
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

//! Module decoration defines the trait,
//! which describes the extra information attached to [crate::syntax] data.

use std::{borrow::Cow, fmt::Debug};

/// `AsUndecorated<T>` is equivalent to [AsRef], with specific meaning.
/// AsRef can be too generic and not suitable for use case.
pub trait AsUndecorated<T: ?Sized> {
    fn as_undecorated(&self) -> &T;
}

/// Decoration associates the extra information attached to
/// [Transaction][super::Transaction] or any other [crate::syntax] data.
/// See [super::plain] or [super::tracked] for implementations.
pub trait Decoration: 'static {
    type Decorated<T>: AsUndecorated<T> + Debug + PartialEq + Eq
    where
        T: AsUndecorated<T> + Debug + PartialEq + Eq;

    fn decorate_parser<PIn, I, O, E>(parser: PIn) -> impl winnow::Parser<I, Self::Decorated<O>, E>
    where
        I: winnow::stream::Stream + winnow::stream::Location,
        O: AsUndecorated<O> + Debug + PartialEq + Eq,
        PIn: winnow::Parser<I, O, E>;
}

macro_rules! define_as_undecorated {
    ([$($impl_generics:tt)*],
     $type_name:ty) => {
        impl<$($impl_generics)*> AsUndecorated<$type_name> for $type_name {
            fn as_undecorated(&self) -> &$type_name {
                self
            }
        }
    };
}

define_as_undecorated!(['i], Cow<'i, str>);
define_as_undecorated!(['i], &'i str);
define_as_undecorated!(['i, Deco: Decoration], super::LedgerEntry<'i, Deco>);
define_as_undecorated!(['i, Deco: Decoration], super::Transaction<'i, Deco>);
define_as_undecorated!(['i, Deco: Decoration], super::Posting<'i, Deco>);
define_as_undecorated!(['i, Deco: Decoration], super::PostingAmount<'i, Deco>);
define_as_undecorated!(['i], super::Exchange<'i>);
define_as_undecorated!(['i], super::expr::ValueExpr<'i>);