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
77
78
79
80
81
82
83
84
85
86
87

/// Configuration for all cache types.
#[derive(Debug, Clone)]
pub struct CacheConfig {
    /// Maximum size for tile cache in MB (0 to disable).
    #[cfg(feature = "_tiles")]
    pub tile_cache_size_mb: u64,
    /// Maximum size for `PMTiles` directory cache in MB (0 to disable).
    #[cfg(feature = "pmtiles")]
    pub pmtiles_cache_size_mb: u64,
    /// Maximum size for sprite cache in MB (0 to disable).
    #[cfg(feature = "sprites")]
    pub sprite_cache_size_mb: u64,
    /// Maximum size for font cache in MB (0 to disable).
    #[cfg(feature = "fonts")]
    pub font_cache_size_mb: u64,
}

impl CacheConfig {
    /// Creates tile cache if configured.
    #[cfg(feature = "_tiles")]
    #[must_use]
    pub fn create_tile_cache(&self) -> Option<martin_core::tiles::TileCache> {
        if self.tile_cache_size_mb > 0 {
            tracing::info!(
                "Initializing tile cache with maximum size {} MB",
                self.tile_cache_size_mb
            );
            let size = self.tile_cache_size_mb * 1000 * 1000;
            Some(martin_core::tiles::TileCache::new(size))
        } else {
            tracing::info!("Tile caching is disabled");
            None
        }
    }

    /// Creates `PMTiles` directory cache if configured.
    #[cfg(feature = "pmtiles")]
    #[must_use]
    pub fn create_pmtiles_cache(&self) -> martin_core::tiles::pmtiles::PmtCache {
        // TODO: make this actually disabled, not just zero sized cached
        if self.pmtiles_cache_size_mb > 0 {
            tracing::info!(
                "Initializing PMTiles directory cache with maximum size {} MB",
                self.pmtiles_cache_size_mb
            );
            let size = self.pmtiles_cache_size_mb * 1000 * 1000;
            martin_core::tiles::pmtiles::PmtCache::new(size)
        } else {
            tracing::debug!("PMTiles directory caching is disabled");
            martin_core::tiles::pmtiles::PmtCache::new(0)
        }
    }

    /// Creates sprite cache if configured.
    #[cfg(feature = "sprites")]
    #[must_use]
    pub fn create_sprite_cache(&self) -> martin_core::sprites::OptSpriteCache {
        if self.sprite_cache_size_mb > 0 {
            tracing::info!(
                "Initializing sprite cache with maximum size {} MB",
                self.sprite_cache_size_mb
            );
            let size = self.sprite_cache_size_mb * 1000 * 1000;
            Some(martin_core::sprites::SpriteCache::new(size))
        } else {
            tracing::info!("Sprite caching is disabled");
            None
        }
    }

    /// Creates font cache if configured.
    #[cfg(feature = "fonts")]
    #[must_use]
    pub fn create_font_cache(&self) -> martin_core::fonts::OptFontCache {
        if self.font_cache_size_mb > 0 {
            tracing::info!(
                "Initializing font cache with maximum size {} MB",
                self.font_cache_size_mb
            );
            let size = self.font_cache_size_mb * 1000 * 1000;
            Some(martin_core::fonts::FontCache::new(size))
        } else {
            tracing::info!("Font caching is disabled");
            None
        }
    }
}