martin-core 0.9.0

Basic building blocks of MapLibre's Martin tile server.
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

//! Error types for the `passthrough` HTTP upstream source.

/// Errors that can occur when proxying tiles from an upstream HTTP tile server.
#[non_exhaustive]
#[derive(thiserror::Error, Debug)]
pub enum PassthroughError {
    /// A per-tile HTTP request to the upstream failed (network, connect, or timeout).
    #[error("Upstream request failed: {0}")]
    Http(#[from] reqwest::Error),

    /// No upstream URL was configured for the source.
    #[error("Passthrough upstream has no URL templates configured")]
    EmptyUrlList,

    /// A configured request header name was not a valid HTTP header name.
    #[error("Invalid header name {name:?} for passthrough upstream: {source}")]
    InvalidHeaderName {
        /// The offending header name as written in the config.
        name: String,
        /// Why the name was rejected.
        #[source]
        source: reqwest::header::InvalidHeaderName,
    },

    /// A configured request header value was not a valid HTTP header value.
    #[error("Invalid value for header {name:?} for passthrough upstream: {source}")]
    InvalidHeaderValue {
        /// The header name whose value was rejected.
        name: String,
        /// Why the value was rejected.
        #[source]
        source: reqwest::header::InvalidHeaderValue,
    },

    /// A configured tile-URL template is missing one of the `{z}`/`{x}`/`{y}` placeholders.
    #[error("Tile URL template {0} must contain {{z}}, {{x}} and {{y}} placeholders")]
    InvalidUrlTemplate(String),

    /// Fetching the upstream `TileJSON` document failed.
    #[error("Failed to fetch TileJSON from {url}: {source}")]
    TileJsonFetch {
        /// The `TileJSON` URL that was requested.
        url: String,
        /// The underlying transport error.
        #[source]
        source: reqwest::Error,
    },

    /// The upstream returned a non-success status for the `TileJSON` document.
    #[error("Fetching TileJSON from {url} returned HTTP status {status}")]
    TileJsonStatus {
        /// The `TileJSON` URL that was requested.
        url: String,
        /// The HTTP status code returned by the upstream.
        status: u16,
    },

    /// The upstream `TileJSON` document could not be parsed.
    #[error("Failed to parse TileJSON from {url}: {source}")]
    TileJsonParse {
        /// The `TileJSON` URL that was requested.
        url: String,
        /// The underlying deserialization error.
        #[source]
        source: serde_json::Error,
    },

    /// The upstream `TileJSON` document contained no entries in its `tiles` array.
    #[error("TileJSON from {0} contained no tile URL templates")]
    NoTilesInTileJson(String),

    /// The tile format could not be derived from config, URL extension, or `TileJSON`.
    #[error(
        "Cannot determine tile format for passthrough source {0}; set `format` explicitly in the config"
    )]
    FormatUndeterminable(String),

    /// A per-tile request returned an unexpected (non-success, non-404/204) HTTP status.
    #[error("Upstream {url} returned unexpected HTTP status {status}")]
    UnexpectedStatus {
        /// The tile URL that was requested.
        url: String,
        /// The HTTP status code returned by the upstream.
        status: u16,
    },
}