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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
# Copyright (c) 2016 Weitian LI <liweitianux@live.com>
# MIT license
"""
Custom validations for the configurations.
NOTE
----
These checker functions check the configurations as a whole, and may check
a config item against its context,
Therefore, they are very different to the checker function of `Validator`.
"""
import os
from ..errors import ConfigError
def _check_missing(configs, keys):
"""Check whether the required config is provided by the user."""
results = {}
if isinstance(keys, str):
keys = [keys, ]
for key in keys:
if not configs.getn(key):
results[key] = "Value required but missing"
return results
def _check_existence(configs, keys):
"""Check whether the file/directory corresponding to the config exists."""
if isinstance(keys, str):
keys = [keys, ]
results = {}
for key in keys:
res = _check_missing(configs, key)
if res == {}:
# Both "key" and "dir_key" are valid
path = configs.get_path(key)
if not os.path.exists(path):
res[key] = 'File/directory not exist: "%s"' % path
results.update(res)
return results
def check_frequency(configs):
"""Check the "[frequency]" section of the configurations."""
results = {}
if configs.getn("frequency/type") == "custom":
results.update(_check_missing(configs, "frequency/frequencies"))
elif configs.getn("frequency/type") == "calc":
results.update(
_check_missing(configs, ["frequency/start",
"frequency/stop",
"frequency/step"])
)
return results
def check_output(configs):
"""Check the "[output]" section of the configurations."""
results = {}
if configs.getn("output/combine"):
results.update(_check_missing(configs, "output/output_dir"))
return results
def check_galactic_synchrotron(configs):
"""Check the "[galactic][synchrotron]" section of the configurations."""
comp = "galactic/synchrotron"
comp_enabled = configs.getn("common/components")
results = {}
if comp in comp_enabled:
# Only validate the configs if this component is enabled
results.update(
_check_missing(configs, [comp+"/template_freq",
comp+"/template_unit"])
)
results.update(
_check_existence(configs, [comp+"/template", comp+"/indexmap"])
)
if configs.getn(comp+"/save"):
results.update(_check_missing(configs, comp+"/output_dir"))
return results
def check_galactic_freefree(configs):
"""Check the "[galactic][freefree]" section of the configurations."""
comp = "galactic/freefree"
comp_enabled = configs.getn("common/components")
results = {}
if comp in comp_enabled:
# Only validate the configs if this component is enabled
results.update(
_check_missing(configs, [comp+"/halphamap_unit",
comp+"/dustmap_unit"])
)
results.update(
_check_existence(configs, [comp+"/halphamap", comp+"/dustmap"])
)
if configs.getn(comp+"/save"):
results.update(_check_missing(configs, comp+"/output_dir"))
return results
def check_galactic_snr(configs):
"""Check the "[galactic][snr]" section of the configurations."""
comp = "galactic/snr"
comp_enabled = configs.getn("common/components")
results = {}
if comp in comp_enabled:
# Only validate the configs if this component is enabled
results.update(
_check_existence(configs, comp+"/catalog")
)
if configs.getn(comp+"/save"):
results.update(_check_missing(configs, comp+"/output_dir"))
return results
# Available checkers to validate the configurations
_CHECKERS = [
check_frequency,
check_output,
check_galactic_synchrotron,
check_galactic_freefree,
check_galactic_snr,
]
def validate_configs(configs, checkers=_CHECKERS):
"""Validate the configurations through the supplied checkers.
These checker usually validate on the global scale, and validate
some specific configs against their contexts.
Parameters
----------
configs : `ConfigManager` object
An `ConfigManager` object contains both default and user
configurations.
checkers : list of functions
List of checker functions through which the configurations
will be validated.
Returns
-------
bool
True if the configurations pass all checker functions, otherwise,
the `ConfigError` will be raised with corresponding message.
Raises
------
ConfigError
If any configuration failed the check, a `ConfigError` with
details will be raised.
"""
results = {}
for checker in checkers:
results.update(checker(configs))
#
if results == {}:
return True
else:
err_msg = "\n".join(['Config "{key}": {msg}'.format(key=key, msg=msg)
for key, msg in results.items()])
raise ConfigError(err_msg)
|
