tablo-core 0.8.0

The core toolkit types for Tablo, a server-rendered admin toolkit on Topcoat and Toasty.
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

use super::*;

fn nav() -> Vec<NavigationItem> {
    vec![
        NavigationItem::at("Dashboard", "/admin"),
        NavigationItem::at("Blog Posts", "/admin/posts"),
        NavigationItem::at("Users", "/admin/users?sort=name"),
    ]
}

/// The resources' lists among [`nav`]'s entries.
const LISTS: [&str; 2] = ["/admin/posts", "/admin/users"];

/// Each crumb's English label, leaked to compare against literals, and its link.
fn labels(crumbs: &[Crumb]) -> Vec<(&'static str, Option<&str>)> {
    crumbs
        .iter()
        .map(|crumb| {
            let label: &'static str = Box::leak(crumb.label.english().into_boxed_str());
            (label, crumb.href.as_deref())
        })
        .collect()
}

/// The longest entry holding the path names the trail, not the home entry every path sits under.
#[test]
fn the_longest_entry_names_the_trail() {
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/posts", "")),
        [("Blog Posts", None)]
    );
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin", "")),
        [("Dashboard", None)]
    );
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/users", "")),
        [("Users", None)],
        "an entry's query is not part of its path"
    );
}

/// Of two entries on one path, the one whose query the request carries names the trail.
#[test]
fn the_entry_the_request_holds_names_the_trail() {
    let items = vec![
        NavigationItem::at("Drafts", "/admin/posts?f.status=draft"),
        NavigationItem::at("Blog Posts", "/admin/posts"),
    ];
    assert_eq!(
        labels(&trail(&items, &LISTS, "/admin/posts", "")),
        [("Blog Posts", None)]
    );
    assert_eq!(
        labels(&trail(&items, &LISTS, "/admin/posts", "f.status=draft")),
        [("Drafts", None)]
    );
}

/// A resource's create, view and edit pages link back to its list.
#[test]
fn resource_pages_link_back_to_the_list() {
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/posts/-/create", "")),
        [("Blog Posts", Some("/admin/posts")), ("Create", None)]
    );
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/posts/7", "")),
        [("Blog Posts", Some("/admin/posts")), ("View", None)]
    );
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/posts/7/edit", "")),
        [("Blog Posts", Some("/admin/posts")), ("Edit", None)]
    );
}

/// A page under a record links the record, then names itself.
#[test]
fn a_page_under_a_record_links_the_record() {
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/posts/7/audit-log", "")),
        [
            ("Blog Posts", Some("/admin/posts")),
            ("View", Some("/admin/posts/7")),
            ("Audit log", None),
        ]
    );
}

/// A path no entry holds has no trail, rather than one that points somewhere else.
#[test]
fn an_unknown_path_has_no_trail() {
    assert!(trail(&nav(), &LISTS, "/elsewhere", "").is_empty());
    assert!(
        trail(&nav(), &LISTS, "/admin-old/posts", "").is_empty(),
        "`/admin` holds only `/admin` and the paths under it"
    );
}

/// A failed page links the entry it is under, then names the failure.
#[test]
fn a_failed_page_names_the_failure_under_its_entry() {
    assert_eq!(
        labels(&failed(&nav(), "/admin/posts/7", "", "Page not found")),
        [
            ("Blog Posts", Some("/admin/posts")),
            ("Page not found", None)
        ]
    );
    assert_eq!(
        labels(&failed(&nav(), "/admin/posts", "", "Access denied")),
        [
            ("Blog Posts", Some("/admin/posts")),
            ("Access denied", None)
        ],
        "the entry links even from its own path"
    );
    assert_eq!(
        labels(&failed(&nav(), "/elsewhere", "", "Page not found")),
        [("Page not found", None)]
    );
}

/// A path under an entry that is no resource's list names its last segment: no record page
/// reads into it.
#[test]
fn a_page_under_another_entry_names_itself() {
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/reports", "")),
        [("Dashboard", Some("/admin")), ("Reports", None)]
    );
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/comments/5/edit", "")),
        [("Dashboard", Some("/admin")), ("Edit", None)]
    );
}

/// A segment the URL percent-encodes reads decoded.
#[test]
fn an_encoded_segment_reads_decoded() {
    assert_eq!(
        labels(&trail(&nav(), &LISTS, "/admin/reports/Q1%20sales", "")),
        [("Dashboard", Some("/admin")), ("Q1 sales", None)]
    );
}