cfgd-core 0.4.0

Core library for cfgd — shared types, providers, reconciler, state
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

//! Indent invariant: indent invariant. 6 cases — covers the runtime indent check
//! at depths 1/2/3, the empty-section collapse rule, suppressed-child
//! collapse, and the buffered-Doc path that never needs the runtime check.

use crate::golden_doc;
use crate::output::Doc;

golden_doc!(indent, depth_one, |p, cap| {
    let s = p.section("X");
    s.bullet("at depth 1");
});

golden_doc!(indent, depth_two, |p, cap| {
    let s = p.section("Outer");
    let n = s.section("Inner");
    n.bullet("at depth 2");
});

golden_doc!(indent, depth_three, |p, cap| {
    let s = p.section("L1");
    let m = s.section("L2");
    let n = m.section("L3");
    n.bullet("deep");
});

golden_doc!(
    indent,
    section_or_collapse_with_no_children_renders_nothing,
    |p, cap| {
        p.heading("Before");
        {
            let _s = p.section_or_collapse("Empty");
        }
        p.heading("After");
    }
);

golden_doc!(
    indent,
    section_with_only_suppressed_hint_collapses,
    |p, cap| {
        // Verbosity-suppressed components don't count as emitted children.
        // At Normal, Note is Verbose-only, so a section that only emits a
        // Note collapses under `section_or_collapse`.
        let s = p.section_or_collapse("MaybeEmpty");
        s.note("verbose-only — suppressed at Normal");
    }
);

golden_doc!(indent, buffered_doc_no_runtime_check_needed, |p, cap| {
    let doc = Doc::new()
        .heading("Buffered")
        .section("Files", |s| s.bullet("foo"));
    p.emit(doc);
});