tabled 0.20.0

An easy to use library for pretty print tables of Rust `struct`s and `enum`s.
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

use crate::{grid::config::Entity, settings::TableOption};

#[cfg(feature = "std")]
use crate::settings::CellOption;

/// Settings is a combinator of [`TableOption`]s.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
pub struct Settings<A = EmptySettings, B = EmptySettings>(A, B);

impl Default for Settings<EmptySettings, EmptySettings> {
    fn default() -> Self {
        Self(EmptySettings, EmptySettings)
    }
}

impl Settings<(), ()> {
    /// Creates an empty list.
    pub const fn empty() -> Settings<EmptySettings, EmptySettings> {
        Settings(EmptySettings, EmptySettings)
    }
}

impl<A, B> Settings<A, B> {
    /// Creates a new combinator.
    pub const fn new(settings1: A, settings2: B) -> Settings<A, B> {
        Settings(settings1, settings2)
    }

    /// Add an option to a combinator.
    pub const fn with<C>(self, settings: C) -> Settings<Self, C> {
        Settings(self, settings)
    }
}

#[cfg(feature = "std")]
impl<R, C, A, B> CellOption<R, C> for Settings<A, B>
where
    A: CellOption<R, C>,
    B: CellOption<R, C>,
{
    fn change(self, records: &mut R, cfg: &mut C, entity: Entity) {
        self.0.change(records, cfg, entity);
        self.1.change(records, cfg, entity);
    }

    fn hint_change(&self) -> Option<Entity> {
        match (self.0.hint_change(), self.1.hint_change()) {
            (None, None) => None,
            (Some(a), Some(b)) => Some(combine_entity(a, b)),
            (None, value) => value,
            (value, None) => value,
        }
    }
}

impl<R, D, C, A, B> TableOption<R, C, D> for Settings<A, B>
where
    A: TableOption<R, C, D>,
    B: TableOption<R, C, D>,
{
    fn change(self, records: &mut R, cfg: &mut C, dims: &mut D) {
        self.0.change(records, cfg, dims);
        self.1.change(records, cfg, dims);
    }

    fn hint_change(&self) -> Option<Entity> {
        match (self.0.hint_change(), self.1.hint_change()) {
            (None, None) => None,
            (Some(a), Some(b)) => Some(combine_entity(a, b)),
            (None, value) => value,
            (value, None) => value,
        }
    }
}

/// A marker structure to be able to create an empty [`Settings`].
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
pub struct EmptySettings;

#[cfg(feature = "std")]
impl<R, C> CellOption<R, C> for EmptySettings {
    fn change(self, _: &mut R, _: &mut C, _: Entity) {}
}

impl<R, D, C> TableOption<R, C, D> for EmptySettings {
    fn change(self, _: &mut R, _: &mut C, _: &mut D) {}
}

pub(crate) fn combine_entity(x1: Entity, x2: Entity) -> Entity {
    use Entity::*;

    match (x1, x2) {
        (Column(a), Column(b)) if a == b => Column(a),
        (Column(a), Cell(_, b)) if a == b => Column(a),
        (Row(a), Row(b)) if a == b => Row(a),
        (Row(a), Cell(b, _)) if a == b => Row(a),
        (Cell(_, a), Column(b)) if a == b => Column(a),
        (Cell(a, _), Row(b)) if a == b => Row(a),
        (Cell(a, b), Cell(a1, b1)) if a == a1 && b == b1 => Cell(a, b),
        _ => Global,
    }
}