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