pedant-core 0.20.2

Analysis engine for pedant: IR extraction, style checks, and capability detection
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

//! Borrowed accessors over a parsed Cargo manifest table.
//!
//! The project model reads manifests without `serde`, which stays behind the
//! judgment surface, so every lookup goes through these helpers.

/// A nested table, when the key holds one.
pub(super) fn table<'a>(parent: &'a toml::Table, key: &str) -> Option<&'a toml::Table> {
    parent.get(key).and_then(toml::Value::as_table)
}

/// A string value, when the key holds one.
pub(super) fn string<'a>(parent: &'a toml::Table, key: &str) -> Option<&'a str> {
    parent.get(key).and_then(toml::Value::as_str)
}

/// A boolean value, or `default` when the key is absent or another type.
pub(super) fn flag(parent: &toml::Table, key: &str, default: bool) -> bool {
    parent
        .get(key)
        .and_then(toml::Value::as_bool)
        .unwrap_or(default)
}

/// Every string in an array value, skipping entries of another type.
pub(super) fn strings(parent: &toml::Table, key: &str) -> Box<[Box<str>]> {
    parent
        .get(key)
        .and_then(toml::Value::as_array)
        .map(|values| {
            values
                .iter()
                .filter_map(toml::Value::as_str)
                .map(Box::<str>::from)
                .collect()
        })
        .unwrap_or_default()
}

/// Every table in an array-of-tables value.
pub(super) fn tables<'a>(parent: &'a toml::Table, key: &str) -> Box<[&'a toml::Table]> {
    parent
        .get(key)
        .and_then(toml::Value::as_array)
        .map(|values| values.iter().filter_map(toml::Value::as_table).collect())
        .unwrap_or_default()
}

/// Whether a key requests workspace inheritance, as in `version.workspace = true`.
pub(super) fn inherits(parent: &toml::Table, key: &str) -> bool {
    table(parent, key).is_some_and(|entry| flag(entry, "workspace", false))
}

/// The first table present among alias spellings of one Cargo key.
pub(super) fn aliased_table<'a>(parent: &'a toml::Table, keys: &[&str]) -> Option<&'a toml::Table> {
    keys.iter().find_map(|key| table(parent, key))
}