martin 1.5.0

Blazing fast and lightweight tile server with PostGIS, MBTiles, and PMTiles support
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

use crate::{MartinError, MartinResult};

#[derive(Debug, Clone)]
pub enum State<T: Clone> {
    Ignore,
    Share(T),
    Take(T),
}

#[derive(Debug)]
pub struct Arguments {
    state: Vec<State<()>>,
    values: Vec<String>,
}

impl Arguments {
    #[must_use]
    pub fn new(values: Vec<String>) -> Self {
        Self {
            state: vec![State::Ignore; values.len()],
            values,
        }
    }

    #[cfg(feature = "_tiles")]
    #[must_use]
    pub fn is_empty(&self) -> bool {
        self.values.is_empty()
    }

    #[cfg(feature = "_tiles")]
    /// Process input params in the original order, but only if no prior consumer has claimed it.
    /// Each consumer can either take it (no other consumer will see it),
    /// share it (other consumers will see it too),
    /// or ignore it (same as sharing, but it is an error if no consumer claims it later)
    pub fn process<T, F>(&mut self, mut handle: F) -> Vec<T>
    where
        T: Clone,
        F: FnMut(&str) -> State<T>,
    {
        let mut result = Vec::new();
        for (i, name) in self.values.iter().enumerate() {
            if matches!(self.state[i], State::Take(())) {
                continue;
            }
            let state = handle(name);
            self.state[i] = match state {
                State::Ignore => State::Ignore,
                State::Share(v) => {
                    result.push(v);
                    State::Share(())
                }
                State::Take(v) => {
                    result.push(v);
                    State::Take(())
                }
            }
        }
        result
    }

    /// Check that all params have been claimed
    pub fn check(self) -> MartinResult<()> {
        let mut unrecognized = Vec::new();
        for (i, value) in self.values.into_iter().enumerate() {
            if let State::Ignore = self.state[i] {
                unrecognized.push(value);
            }
        }
        if unrecognized.is_empty() {
            Ok(())
        } else {
            Err(MartinError::UnrecognizableConnections(unrecognized))
        }
    }
}