tablo-test 0.9.0

In-memory HTTP test client for Tablo panels, re-exported as `tablo::testing`.
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

//! Reads a page's action buttons: whether one confirms before it posts, whether the bulk bar
//! offers every matching record, and which custom actions show disabled with their reason.

use super::dom::{Attrs, Element, attr_value, elements, open_tags, strip_text};

/// A custom action whose button shows disabled, as the record's state refuses it.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct DisabledAction {
    /// The action's `NAME`.
    pub name: String,
    /// Why the button is disabled, as the action's `disabled_reason` words it.
    pub reason: String,
}

/// Whether the button posting to `action` asks first: a confirming trigger is a plain button that
/// opens the dialog, a direct write is a submit button. `None` when no button posts there.
pub fn confirms_first(html: &str, action: &str) -> Option<bool> {
    open_tags(html)
        .into_iter()
        .find(|(tag, attrs, _)| {
            tag == "button" && attr_value(attrs, "formaction").as_deref() == Some(action)
        })
        .map(|(_, attrs, _)| attr_value(&attrs, "type").as_deref() == Some("button"))
}

/// The button posting to `url`, a custom action's route, on a row or a record page, as its
/// element. A row's button posts itself; a record page's button sits in the form posting to `url`.
fn posting_button(html: &str, url: &str) -> Option<Element> {
    let posts_to = |attrs: &Attrs, name: &str| {
        attr_value(attrs, name).is_some_and(|posted| posted.split('?').next() == Some(url))
    };
    elements(html, "button")
        .into_iter()
        .find(|(_, attrs, _)| posts_to(attrs, "formaction"))
        .or_else(|| {
            elements(html, "form")
                .into_iter()
                .find(|(_, attrs, _)| posts_to(attrs, "action"))
                .and_then(|(_, _, inner)| elements(&inner, "button").into_iter().next())
        })
}

/// The text of the button posting to `url`, its icon aside. `None` when no button posts there.
pub fn action_label(html: &str, url: &str) -> Option<String> {
    posting_button(html, url).map(|(_, _, inner)| strip_text(&inner))
}

/// The hint the button posting to `url` shows on hover. `None` when no button posts there or it
/// shows none.
pub fn action_tooltip(html: &str, url: &str) -> Option<String> {
    posting_button(html, url).and_then(|(_, attrs, _)| attr_value(&attrs, "title"))
}

/// The count a header action's button shows as its badge, posting to `url`. `None` when no button
/// posts there or it shows no badge.
pub fn action_badge(html: &str, url: &str) -> Option<String> {
    let (_, _, inner) = posting_button(html, url)?;
    elements(&inner, "span")
        .into_iter()
        .find(|(_, attrs, _)| attr_value(attrs, "data-action-badge").is_some())
        .map(|(_, _, count)| strip_text(&count))
}

/// Whether the bulk bar offers to select every record the list's query selects, beyond its page.
pub fn selects_matching(html: &str) -> bool {
    open_tags(html).iter().any(|(tag, attrs, _)| {
        tag == "button" && attr_value(attrs, "data-select-matching").is_some()
    })
}

/// The custom actions `html` shows disabled, in document order: a row's, or a record page
/// header's.
pub fn disabled_actions(html: &str) -> Vec<DisabledAction> {
    open_tags(html)
        .into_iter()
        .filter_map(|(_, attrs, _)| {
            Some(DisabledAction {
                name: attr_value(&attrs, "data-disabled-action")?,
                reason: attr_value(&attrs, "title").unwrap_or_default(),
            })
        })
        .collect()
}