Coverage for gws-app / gws / gis / mpx / config.py: 57%

1"""MapProxy configuration module for GWS. 

2 

3This module provides functions and classes to create and manage MapProxy configurations. 

4""" 

5 

6from typing import Any, Dict, Generator, List, Optional, Tuple, cast 

7 

8import yaml 

9 

10from mapproxy.wsgiapp import make_wsgi_app 

11 

12import gws 

13import gws.lib.osx 

14 

15CONFIG_PATH = gws.c.CONFIG_DIR + '/mapproxy.yaml' 

16 

17DEFAULT_CONFIG = { 

18 "services": { 

19 "wmts": { 

20 } 

21 }, 

22 "sources": { 

23 "test": { 

24 "type": "tile", 

25 "url": "https://osmtiles.gbd-consult.de/ows/%(z)s/%(x)s/%(y)s.png", 

26 } 

27 }, 

28 "layers": [ 

29 { 

30 "name": "test", 

31 "title": "test", 

32 "sources": [ 

33 "test" 

34 ] 

35 } 

36 ] 

37} 

38 

39 

40class _Config: 

41 """Internal configuration builder for MapProxy. 

42  

43 This class helps build a MapProxy configuration by collecting and organizing 

44 configuration elements from GWS layers. 

45 """ 

46 

47 def __init__(self) -> None: 

48 """Initialize a new MapProxy configuration builder.""" 

49 self.c = 0 

50 

51 self.services = { 

52 'wms': { 

53 'image_formats': ['image/png'], 

54 'max_output_pixels': [9000, 9000] 

55 }, 

56 'wmts': { 

57 'kvp': True, 

58 'restful': False 

59 } 

60 } 

61 

62 self.globals = { 

63 # https://mapproxy.org/docs/1.11.0/configuration.html#id14 

64 # "By default MapProxy assumes lat/long (north/east) order for all geographic and x/y (east/north) order for all projected SRS." 

65 # we need to change that because our extents are always x/y (lon/lat) even if a CRS says otherwise 

66 'srs': { 

67 'axis_order_en': ['EPSG:4326'] 

68 }, 

69 'cache': { 

70 'base_dir': gws.c.MAPPROXY_CACHE_DIR, 

71 'lock_dir': gws.u.ensure_dir(gws.c.TRANSIENT_DIR + '/mpx_locks_' + gws.u.random_string(16)), 

72 'tile_lock_dir': gws.u.ensure_dir(gws.c.TRANSIENT_DIR + '/mpx_tile_locks_' + gws.u.random_string(16)), 

73 'concurrent_tile_creators': 1, 

74 'max_tile_limit': 5000, 

75 

76 }, 

77 'image': { 

78 'resampling_method': 'bicubic', 

79 'stretch_factor': 1.15, 

80 'max_shrink_factor': 4.0, 

81 

82 'formats': { 

83 'png8': { 

84 'format': 'image/png', 

85 'mode': 'P', 

86 'colors': 256, 

87 'transparent': True, 

88 'resampling_method': 'bicubic', 

89 }, 

90 'png24': { 

91 'format': 'image/png', 

92 'mode': 'RGBA', 

93 'colors': 0, 

94 'transparent': True, 

95 'resampling_method': 'bicubic', 

96 } 

97 

98 } 

99 }, 

100 'http': { 

101 'hide_error_details': False, 

102 } 

103 } 

104 

105 self.cfg = {} 

106 

107 def _add(self, kind: str, c: Dict[str, Any]) -> str: 

108 """Add a configuration element to the internal registry. 

109  

110 Args: 

111 kind: The type of configuration element ('source', 'grid', etc.). 

112 c: The configuration dictionary. 

113  

114 Returns: 

115 A unique identifier for the added configuration element. 

116 """ 

117 # mpx doesn't like tuples 

118 for k, v in c.items(): 

119 if isinstance(v, tuple): 

120 c[k] = list(v) 

121 

122 uid = kind + '_' + gws.u.sha256(c) 

123 

124 # clients might add their hash params starting with '$' 

125 c = { 

126 k: v 

127 for k, v in c.items() 

128 if not k.startswith('$') 

129 } 

130 

131 self.cfg[uid] = {'kind': kind, 'c': c} 

132 return uid 

133 

134 def _items(self, kind: str) -> Generator[Tuple[str, Dict[str, Any]], None, None]: 

135 """Get all configuration elements of a specific kind. 

136  

137 Args: 

138 kind: The type of configuration element to retrieve. 

139  

140 Yields: 

141 Tuples of (uid, configuration) for each matching element. 

142 """ 

143 for k, v in self.cfg.items(): 

144 if v['kind'] == kind: 

145 yield k, v['c'] 

146 

147 def cache(self, c: Dict[str, Any]) -> str: 

148 """Add a cache configuration. 

149  

150 Args: 

151 c: The cache configuration dictionary. 

152  

153 Returns: 

154 A unique identifier for the added cache configuration. 

155 """ 

156 return self._add('cache', c) 

157 

158 def source(self, c: Dict[str, Any]) -> str: 

159 """Add a source configuration. 

160  

161 Args: 

162 c: The source configuration dictionary. 

163  

164 Returns: 

165 A unique identifier for the added source configuration. 

166 """ 

167 return self._add('source', c) 

168 

169 def grid(self, c: Dict[str, Any]) -> str: 

170 """Add a grid configuration. 

171  

172 Args: 

173 c: The grid configuration dictionary. 

174  

175 Returns: 

176 A unique identifier for the added grid configuration. 

177 """ 

178 # self._transform_extent(c) 

179 return self._add('grid', c) 

180 

181 def layer(self, c: Dict[str, Any]) -> str: 

182 """Add a layer configuration. 

183  

184 Args: 

185 c: The layer configuration dictionary. 

186  

187 Returns: 

188 A unique identifier for the added layer configuration. 

189 """ 

190 c['title'] = '' 

191 return self._add('layer', c) 

192 

193 def to_dict(self) -> Dict[str, Any]: 

194 """Convert the configuration to a dictionary suitable for MapProxy. 

195  

196 Returns: 

197 A dictionary containing the complete MapProxy configuration. 

198 """ 

199 d = { 

200 'services': self.services, 

201 'globals': self.globals, 

202 'layers': [], 

203 } 

204 

205 kinds = ['source', 'grid', 'cache', 'layer'] 

206 for kind in kinds: 

207 d[kind + 's'] = { 

208 key: c 

209 for key, c in self._items(kind) 

210 } 

211 

212 d['layers'] = sorted(d['layers'].values(), key=lambda x: x['name']) 

213 

214 return d 

215 

216 

217def create(root: gws.Root) -> Optional[Dict[str, Any]]: 

218 """Create a MapProxy configuration from the GWS root object. 

219  

220 This function collects configuration from all layers that provide 

221 MapProxy configuration and builds a complete MapProxy configuration. 

222  

223 Args: 

224 root: The GWS root object. 

225  

226 Returns: 

227 A dictionary containing the complete MapProxy configuration, 

228 or None if no layers provide MapProxy configuration. 

229 """ 

230 mc = _Config() 

231 

232 for layer in root.find_all(gws.ext.object.layer): 

233 m = getattr(layer, 'mapproxy_config', None) 

234 if m: 

235 m(mc) 

236 

237 cfg = mc.to_dict() 

238 if not cfg.get('layers'): 

239 return None 

240 

241 crs: list[gws.Crs] = [] 

242 for p in root.find_all(gws.ext.object.map): 

243 crs.append(cast(gws.Map, p).bounds.crs) 

244 for p in root.find_all(gws.ext.object.owsService): 

245 crs.extend(b.crs for b in getattr(p, 'supportedBounds', [])) 

246 cfg['services']['wms']['srs'] = sorted(set(c.epsg for c in crs)) 

247 

248 return cfg 

249 

250 

251def create_and_save(root: gws.Root) -> Optional[Dict[str, Any]]: 

252 """Create a MapProxy configuration and save it to disk. 

253  

254 This function creates a MapProxy configuration and saves it to the 

255 configured path. It also validates the configuration by attempting 

256 to load it with MapProxy. 

257  

258 Args: 

259 root: The GWS root object. 

260  

261 Returns: 

262 The created configuration dictionary, or None if no configuration 

263 was created and force start is not enabled. 

264  

265 Raises: 

266 gws.Error: If the configuration is invalid. 

267 """ 

268 cfg = create(root) 

269 

270 if not cfg: 

271 force = root.app.cfg('server.mapproxy.forceStart') 

272 if force: 

273 gws.log.warning('mapproxy: no configuration, using default') 

274 cfg = DEFAULT_CONFIG 

275 else: 

276 gws.log.warning('mapproxy: no configuration, not starting') 

277 gws.lib.osx.unlink(CONFIG_PATH) 

278 return None 

279 

280 cfg_str = yaml.dump(cfg) 

281 

282 # make sure the config is ok before starting the server! 

283 test_path = CONFIG_PATH + '.test.yaml' 

284 gws.u.write_file(test_path, cfg_str) 

285 

286 try: 

287 make_wsgi_app(test_path) 

288 except Exception as e: 

289 raise gws.Error(f'MAPPROXY ERROR: {e!r}') from e 

290 

291 gws.lib.osx.unlink(test_path) 

292 

293 # write into the real config path 

294 gws.u.write_file(CONFIG_PATH, cfg_str) 

295 

296 return cfg