fluxnet_shuttle.log_trace

fluxnet_shuttle.log_trace(exception, level=40, log=<Logger fluxnet_shuttle (WARNING)>, output_fmt='std')[source]

Logs exception including stack traceback into log, formatting trace as single line

Parameters:

  • exception (Exception) – exception object to be handled

  • level (int) – logging severity level

  • log (logging.Logger) – logger to use for logging trace

  • output_fmt (str) – output format: std (like Python traceback) or alt (‘;’-separated single line)

Return type:

str

>>> # N.B.: careful when catching Exception class,
>>> #       this can mask virtually any error in Python
>>> try:
>>>     raise Exception('Test exception')
>>> except Exception as e:
>>>     msg = log_trace(exception=e, level=logging.CRITICAL)
>>>     sys.exit(msg)