LSST Applications g042eb84c57+730a74494b,g04e9c324dd+8c5ae1fdc5,g134cb467dc+1f1e3e7524,g199a45376c+0ba108daf9,g1fd858c14a+fa7d31856b,g210f2d0738+f66ac109ec,g262e1987ae+83a3acc0e5,g29ae962dfc+d856a2cb1f,g2cef7863aa+aef1011c0b,g35bb328faa+8c5ae1fdc5,g3fd5ace14f+a1e0c9f713,g47891489e3+0d594cb711,g4d44eb3520+c57ec8f3ed,g4d7b6aa1c5+f66ac109ec,g53246c7159+8c5ae1fdc5,g56a1a4eaf3+fd7ad03fde,g64539dfbff+f66ac109ec,g67b6fd64d1+0d594cb711,g67fd3c3899+f66ac109ec,g6985122a63+0d594cb711,g74acd417e5+3098891321,g786e29fd12+668abc6043,g81db2e9a8d+98e2ab9f28,g87389fa792+8856018cbb,g89139ef638+0d594cb711,g8d7436a09f+80fda9ce03,g8ea07a8fe4+760ca7c3fc,g90f42f885a+033b1d468d,g97be763408+a8a29bda4b,g99822b682c+e3ec3c61f9,g9d5c6a246b+0d5dac0c3d,ga41d0fce20+9243b26dd2,gbf99507273+8c5ae1fdc5,gd7ef33dd92+0d594cb711,gdab6d2f7ff+3098891321,ge410e46f29+0d594cb711,geaed405ab2+c4bbc419c6,gf9a733ac38+8c5ae1fdc5,w.2025.38
LSST Data Management Base Package
Loading...
Searching...
No Matches
lsst.pex.config.history Namespace Reference

Classes

class  Color
 

Functions

 _colorize (text, category)
 
 format (config, name=None, writeSourceLine=True, prefix="", verbose=False)
 

Function Documentation

◆ _colorize()

lsst.pex.config.history._colorize ( text,
category )
protected

Definition at line 168 of file history.py.

168def _colorize(text, category):
169 text = Color(text, category)
170 return str(text)
171
172

◆ format()

lsst.pex.config.history.format ( config,
name = None,
writeSourceLine = True,
prefix = "",
verbose = False )
Format the history record for a configuration, or a specific
configuration field.

Parameters
----------
config : `lsst.pex.config.Config`
    A configuration instance.
name : `str`, optional
    The name of a configuration field to specifically format the history
    for. Otherwise the history of all configuration fields is printed.
writeSourceLine : `bool`, optional
    If `True`, prefix each printout line with the code filename and line
    number where the configuration event occurred. Default is `True`.
prefix : `str`, optional
    A prefix for to add to each printout line. This prefix occurs first,
    even before any source line. The default is an empty string.
verbose : `bool`, optional
    Default is `False`.

Definition at line 173 of file history.py.

173def format(config, name=None, writeSourceLine=True, prefix="", verbose=False):
174 """Format the history record for a configuration, or a specific
175 configuration field.
176
177 Parameters
178 ----------
179 config : `lsst.pex.config.Config`
180 A configuration instance.
181 name : `str`, optional
182 The name of a configuration field to specifically format the history
183 for. Otherwise the history of all configuration fields is printed.
184 writeSourceLine : `bool`, optional
185 If `True`, prefix each printout line with the code filename and line
186 number where the configuration event occurred. Default is `True`.
187 prefix : `str`, optional
188 A prefix for to add to each printout line. This prefix occurs first,
189 even before any source line. The default is an empty string.
190 verbose : `bool`, optional
191 Default is `False`.
192 """
193 if name is None:
194 for i, name in enumerate(config.history.keys()):
195 if i > 0:
196 print()
197 print(format(config, name))
198
199 outputs = []
200 for value, stack, _ in config.history.get(name, []):
201 output = []
202 for frame in stack:
203 if frame.function in (
204 "__new__",
205 "__set__",
206 "__setattr__",
207 "execfile",
208 "wrapper",
209 ) or os.path.split(frame.filename)[1] in ("argparse.py", "argumentParser.py"):
210 if not verbose:
211 continue
212
213 line = []
214 if writeSourceLine:
215 line.append(
216 [
217 f"{frame.filename}:{frame.lineno}",
218 "FILE",
219 ]
220 )
221
222 line.append(
223 [
224 frame.content,
225 "TEXT",
226 ]
227 )
228 if False:
229 line.append(
230 [
231 frame.function,
232 "FUNCTION_NAME",
233 ]
234 )
235
236 output.append(line)
237
238 outputs.append([value, output])
239
240 if outputs:
241 # Find the maximum widths of the value and file:lineNo fields.
242 if writeSourceLine:
243 sourceLengths = []
244 for _, output in outputs:
245 sourceLengths.append(max([len(x[0][0]) for x in output]))
246 sourceLength = max(sourceLengths)
247
248 valueLength = len(prefix) + max([len(str(value)) for value, _ in outputs])
249
250 # Generate the config history content.
251 msg = []
252 fullname = f"{config._name}.{name}" if config._name is not None else name
253 msg.append(_colorize(re.sub(r"^root\.", "", fullname), "NAME"))
254 for value, output in outputs:
255 line = prefix + _colorize(f"{value:<{valueLength}}", "VALUE") + " "
256 for i, vt in enumerate(output):
257 if writeSourceLine:
258 vt[0][0] = f"{vt[0][0]:<{sourceLength}}"
259
260 output[i] = " ".join([_colorize(v, t) for v, t in vt])
261
262 line += f"\n{'':>{valueLength + 1}}".join(output)
263 msg.append(line)
264
265 return "\n".join(msg)