ic-query 0.93.2

Internet Computer query library for CloudEngine, NNS, SNS, ICRC, system canisters, and public network metadata
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

//! Match caller-normalized identifiers; callers own ordering, deduplication and diagnostics.

///
/// IdentifierMatch
///
/// Exact or prefix selection retaining caller items and ambiguity order.
///

pub enum IdentifierMatch<Item> {
    Exact(Item),
    Prefix(Item),
    Missing,
    Ambiguous(Vec<Item>),
}

pub fn match_identifier<Item>(
    identifiers: impl Iterator<Item = Item>,
    text: impl Fn(&Item) -> &str,
    exact: Option<&str>,
    prefix: &str,
) -> IdentifierMatch<Item> {
    let mut matches = Vec::new();
    for identifier in identifiers {
        let candidate = text(&identifier);
        if Some(candidate) == exact {
            return IdentifierMatch::Exact(identifier);
        }
        if !prefix.is_empty() && candidate.starts_with(prefix) {
            matches.push(identifier);
        }
    }
    match matches.len() {
        0 => IdentifierMatch::Missing,
        1 => IdentifierMatch::Prefix(matches.pop().expect("one prefix match")),
        _ => IdentifierMatch::Ambiguous(matches),
    }
}

#[cfg(test)]
mod tests;