Source code for toil.lib.exceptions

# Copyright (C) 2015-2018 Regents of the University of California
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# 5.14.2018: copied into Toil from https://github.com/BD2KGenomics/bd2k-python-lib

import sys


# TODO: isn't this built in to Python 3 now?
[docs] class panic: """ The Python idiom for reraising a primary exception fails when the except block raises a secondary exception, e.g. while trying to cleanup. In that case the original exception is lost and the secondary exception is reraised. The solution seems to be to save the primary exception info as returned from sys.exc_info() and then reraise that. This is a contextmanager that should be used like this try: # do something that can fail except: with panic( log ): # do cleanup that can also fail If a logging logger is passed to panic(), any secondary Exception raised within the with block will be logged. Otherwise those exceptions are swallowed. At the end of the with block the primary exception will be reraised. """ def __init__( self, log=None ): super().__init__( ) self.log = log self.exc_info = None
[docs] def __enter__( self ): self.exc_info = sys.exc_info( )
[docs] def __exit__( self, *exc_info ): if self.log is not None and exc_info and exc_info[ 0 ]: self.log.warning( "Exception during panic", exc_info=exc_info ) exc_type, exc_value, traceback = self.exc_info raise_(exc_type, exc_value, traceback)
[docs] def raise_(exc_type, exc_value, traceback) -> None: if exc_value is not None: exc = exc_value else: exc = exc_type if exc.__traceback__ is not traceback: raise exc.with_traceback(traceback) raise exc