Project

General

Profile

1 11 aaronmk
# Exception handling
2
3 1371 aaronmk
import copy
4 433 aaronmk
import atexit
5 343 aaronmk
import sys
6 1368 aaronmk
import traceback
7 13 aaronmk
8 989 aaronmk
import format
9 343 aaronmk
import strings
10 826 aaronmk
import term
11 343 aaronmk
import util
12
13 445 aaronmk
def raise_(e): raise e
14
15 1371 aaronmk
def sys_traceback():
16
    '''Note that Python tracebacks seems to have a bug that truncates them to
17
    only a few stack frames. See <http://bugs.python.org/issue7378>.'''
18
    return sys.exc_info()[2]
19
        # can't just return pointer to traceback because it will change :-(
20 1368 aaronmk
21 1576 aaronmk
def has_tracebacks(e): return hasattr(e, 'tracebacks')
22 1368 aaronmk
23 1371 aaronmk
def add_traceback(e):
24
    '''Adds current traceback to an exception if it doesn't already have one'''
25
    traceback_ = sys_traceback() # get first in case later code throws exception
26 1576 aaronmk
    if not has_tracebacks(e): e.tracebacks = []
27
    if util.list_get(e.tracebacks, 0) == traceback_: return
28
    e.tracebacks.insert(0, traceback_) # tracebacks have most recent call last
29 1371 aaronmk
30 1576 aaronmk
def get_traceback_str(traceback_):
31 1371 aaronmk
    return ''.join(traceback.format_exception(None, None, traceback_)[:-1])
32
        # remove final "None" line ("exception name")
33
34 1576 aaronmk
def get_e_tracebacks_str(e):
35
    try: tracebacks = e.tracebacks
36
    except AttributeError: return ''
37
    return ''.join(get_traceback_str(t) for t in tracebacks)
38
39 343 aaronmk
def add_msg(e, msg): e.args = (strings.ensure_newl(str(e))+msg,)
40
41 286 aaronmk
def repl_msg(e, **repls): e.args = (str(e) % repls,)
42 279 aaronmk
43 974 aaronmk
def e_ct_exit_status(e_ct): return min(e_ct, 255)
44
45 13 aaronmk
class ExceptionWithCause(Exception):
46
    def __init__(self, msg, cause=None):
47
        Exception.__init__(self, msg)
48 1371 aaronmk
        add_traceback(self)
49 788 aaronmk
        if cause != None: add_msg(self, 'cause: '+str_(cause))
50 343 aaronmk
51 1371 aaronmk
def str_(e): return ''.join(traceback.format_exception_only(type(e), e))
52 433 aaronmk
53 1371 aaronmk
def print_ex(e, emph=True):
54 1576 aaronmk
    msg = strings.ensure_newl(str_(e))+get_e_tracebacks_str(e)
55 826 aaronmk
    if emph:
56
        first_line, nl, rest = msg.partition('\n')
57
        msg = term.error(first_line)+nl+rest
58
    sys.stderr.write(msg)
59 788 aaronmk
60 433 aaronmk
class ExTracker:
61
    def __init__(self):
62
        self.e_ct = 0
63
64 974 aaronmk
    def msg(self): return 'Encountered '+str(self.e_ct)+' error(s)'
65
66 433 aaronmk
    def track(self, e, **format):
67
        self.e_ct += 1
68
        print_ex(e, **format)
69 985 aaronmk
70
    def exit(self):
71
        if self.e_ct > 0: raise SystemExit(e_ct_exit_status(self.e_ct))
72 975 aaronmk
73
class ExPercentTracker(ExTracker):
74 983 aaronmk
    def __init__(self, iter_text='iteration'):
75 977 aaronmk
        ExTracker.__init__(self)
76 983 aaronmk
        self.iter_text = iter_text
77 977 aaronmk
        self.iter_ct = None
78 975 aaronmk
79 977 aaronmk
    def add_iters(self, iter_ct):
80
        if self.iter_ct == None: self.iter_ct = 0
81
        self.iter_ct += iter_ct
82
83
    def msg(self):
84
        msg = ExTracker.msg(self)
85 989 aaronmk
        if self.iter_ct != None: msg += ('/'+format.int2str(self.iter_ct)+' '
86 988 aaronmk
            +self.iter_text+'(s) = '
87 989 aaronmk
            +format.to_percent(float(self.e_ct)/self.iter_ct))
88 977 aaronmk
        return msg