restful 0.2.0

REST API helpers: validated Axum extractors, response envelopes, pagination, ordering, and field selection
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

use std::collections::HashSet;
use std::hash::Hash;

/// Per-namespace (resource) state during parsing and validation.
pub(crate) struct ParsingState<T: Hash + Eq> {
    /// `<namespace>.all` (or bare `all` for top-level) was specified.
    pub has_all: bool,
    /// Explicit includes for this namespace.
    pub include: HashSet<T>,
    /// Explicitly excluded with `-`.
    pub exclude: HashSet<String>,
}

impl<T: Hash + Eq> Default for ParsingState<T> {
    fn default() -> Self {
        Self {
            has_all: false,
            include: HashSet::new(),
            exclude: HashSet::new(),
        }
    }
}

/// Split a wire name into `(namespace, leaf)` at the last dot, so nested
/// namespaces stay intact (`child.grand.name` -> `("child.grand", "name")`).
/// Top-level names return `("", name)`.
pub(crate) fn split_ns(name: &str) -> (&str, &str) {
    match name.rsplit_once('.') {
        Some((ns, leaf)) => (ns, leaf),
        None => ("", name),
    }
}

/// Return `name` qualified with `resource` if it has no namespace prefix yet.
pub(crate) fn qualify(resource: &str, name: &str) -> String {
    if name.contains('.') {
        name.to_string()
    } else {
        format!("{resource}.{name}")
    }
}