shikane 1.0.1

dynamic output configuration tool focusing on accuracy and determinism
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use std::fmt::Display;

use serde::{Deserialize, Serialize};

use super::{SingleSearch, SingleSearchResult};

#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct MultiSearchResult {
    searches: Vec<SingleSearchResult>,
}

#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
#[serde(transparent)]
pub struct MultiSearch {
    searches: Vec<SingleSearch>,
}

#[derive(Clone, Debug, PartialEq)]
pub struct MultiQuery<'a> {
    search: MultiSearch,
    description: &'a str,
    model: &'a str,
    name: &'a str,
    serial: &'a str,
    vendor: &'a str,
}

impl MultiSearchResult {
    /// Returns `true` if all inner [`SingleSearchResult::is_ok()`]s return `true` too.
    pub fn is_ok(&self) -> bool {
        self.searches.iter().all(|ssr| ssr.is_ok())
    }

    /// Returns the sum of all inner [`SingleSearchResult::specificity()`].
    pub fn specificity(&self) -> u64 {
        self.searches.iter().map(|ssr| ssr.specificity()).sum()
    }
}

impl MultiSearch {
    pub fn new(searches: Vec<SingleSearch>) -> Self {
        Self { searches }
    }
    pub fn iter(&self) -> impl Iterator<Item = &SingleSearch> {
        self.searches.iter()
    }
    pub fn query<'a>(self) -> MultiQuery<'a> {
        MultiQuery::new(self)
    }
}

impl<'a> MultiQuery<'a> {
    pub fn new(search: MultiSearch) -> Self {
        Self {
            search,
            description: Default::default(),
            model: Default::default(),
            name: Default::default(),
            serial: Default::default(),
            vendor: Default::default(),
        }
    }
    pub fn description(mut self, description: &'a str) -> Self {
        self.description = description;
        self
    }
    pub fn model(mut self, model: &'a str) -> Self {
        self.model = model;
        self
    }
    pub fn name(mut self, name: &'a str) -> Self {
        self.name = name;
        self
    }
    pub fn serial(mut self, serial: &'a str) -> Self {
        self.serial = serial;
        self
    }
    pub fn vendor(mut self, vendor: &'a str) -> Self {
        self.vendor = vendor;
        self
    }
    pub fn run(self) -> MultiSearchResult {
        let mut ssrs: Vec<SingleSearchResult> = vec![];
        for ss in self.search.searches {
            let ssr = ss
                .query()
                .description(self.description)
                .model(self.model)
                .name(self.name)
                .serial(self.serial)
                .vendor(self.vendor)
                .run();
            ssrs.push(ssr);
        }
        MultiSearchResult { searches: ssrs }
    }
}

impl Display for MultiSearch {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "[")?;
        for (i, search) in self.searches.iter().enumerate() {
            if i != 0 {
                write!(f, ", ")?;
            }
            search.fmt(f)?;
        }
        write!(f, "]")
    }
}