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

//! Reads a creatable choice's link to the related create page, and the page a create framed by
//! its dialog lands on.

use super::dom::{attr_value, open_tags};

/// A creatable choice's link: the select it creates a record for, and the create page it opens.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct CreateOptionLink {
    /// The DOM id of the select whose choice the created record becomes.
    pub select: String,
    /// The related resource's create page.
    pub href: String,
}

/// What the page a create framed by a creatable choice's dialog lands on offers.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum Picked {
    /// The record the choice takes: its key and its title.
    Option {
        /// The record's key, the option's value.
        value: String,
        /// The record's title, the option's label.
        label: String,
    },
    /// The record was created, but the user may not choose it.
    Unchoosable,
}

/// Each creatable choice's link on the page.
pub fn create_option_links(html: &str) -> Vec<CreateOptionLink> {
    let tags = open_tags(html);
    tags.iter()
        .filter(|(tag, _, _)| tag == "a")
        .filter_map(|(_, attrs, _)| {
            let dialog = attr_value(attrs, "data-create-option")?;
            let select = tags.iter().find_map(|(tag, attrs, _)| {
                (tag == "dialog" && attr_value(attrs, "id").as_deref() == Some(dialog.as_str()))
                    .then(|| attr_value(attrs, "data-create-option-select"))
                    .flatten()
            })?;
            Some(CreateOptionLink {
                select,
                href: attr_value(attrs, "href")?,
            })
        })
        .collect()
}

/// What the landing page of a framed create offers, or `None` on any other page.
pub fn picked(html: &str) -> Option<Picked> {
    open_tags(html).into_iter().find_map(|(_, attrs, _)| {
        if attr_value(&attrs, "data-picked-hidden").is_some() {
            return Some(Picked::Unchoosable);
        }
        attr_value(&attrs, "data-picked")?;
        Some(Picked::Option {
            value: attr_value(&attrs, "data-picked-value")?,
            label: attr_value(&attrs, "data-picked-label")?,
        })
    })
}

/// Whether the page's guarded form posts back in pick mode, so a refused save of a create framed
/// by a creatable choice's dialog stays in the dialog.
pub fn posts_picking(html: &str) -> bool {
    open_tags(html).iter().any(|(tag, attrs, _)| {
        tag == "form"
            && attr_value(attrs, "data-form-guard").is_some()
            && attr_value(attrs, "action").is_some_and(|action| {
                action
                    .split_once('?')
                    .is_some_and(|(_, query)| query.split('&').any(|pair| pair == "pick=1"))
            })
    })
}