spectrum 0.0.0

A library for building structured, colorful output. Under heavy development, and doesn't work yet
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

mod renderer;

use pretty::BoxDoc;

use crate::{StyledFragment, StyledFragmentTrait, StyledNewline};

type ColumnFn = Box<dyn Fn(usize) -> Structure + 'static>;

#[allow(unused)]
pub enum Structure {
    Empty,
    Fragment(StyledFragment),
    /// must be a newline
    Hardline,
    /// If possible, a group is laid out inline. If not possible,
    /// each element in the group is laid out as its own block.
    Group(Box<Structure>),
    /// A collection of structures
    List(Vec<Structure>),
    Alt {
        inline: Box<Structure>,
        block: Box<Structure>,
    },
    Nested {
        indent: isize,
        structure: Box<Structure>,
    },
    ForColumn(ColumnFn),
    ForNesting(ColumnFn),
}

impl Structure {
    #[allow(unused)]
    pub fn fragment(frag: impl Into<StyledFragment>) -> Structure {
        Structure::Fragment(frag.into())
    }

    #[allow(unused)]
    pub fn append(self, structure: impl Into<Structure>) -> Structure {
        match self {
            Structure::List(mut v) => {
                v.push(structure.into());
                Structure::List(v)
            }

            other => Structure::List(vec![other, structure.into()]),
        }
    }

    #[allow(unused)]
    pub fn render(&self) -> BoxDoc<StyledFragment> {
        match self {
            Structure::Empty => BoxDoc::nil(),
            Structure::Fragment(frag) => BoxDoc::text(frag.plain()).annotate(frag.clone()),
            Structure::Hardline => BoxDoc::hardline().annotate(StyledNewline.clone_frag()),
            Structure::Group(s) => s.render().group(),
            Structure::List(items) => {
                let mut s = BoxDoc::nil();

                for item in items {
                    s = s.append(item.render())
                }

                s
            }
            Structure::Alt { inline, block } => BoxDoc::flat_alt(inline.render(), block.render()),
            Structure::Nested { indent, structure } => structure.render().nest(*indent),
            Structure::ForColumn(_) => todo!(),
            Structure::ForNesting(_) => todo!(),
        }
    }
}