# Exception handling

import atexit

import sys

import strings

import term

import util

def raise_(e): raise e

def add_msg(e, msg): e.args = (strings.ensure_newl(str(e))+msg,)

def repl_msg(e, **repls): e.args = (str(e) % repls,)

def e_ct_exit_status(e_ct): return min(e_ct, 255)

class ExceptionWithCause(Exception):

    def __init__(self, msg, cause=None):

        Exception.__init__(self, msg)

        if cause != None: add_msg(self, 'cause: '+str_(cause))

def str_(e, with_name=True):

    msg = strings.ensure_newl(str(e))

    if with_name: msg = util.type_name(e)+': '+msg

    return msg

def print_ex(e, emph=True, **format):

    msg = str_(e, **format)

    if emph:

        first_line, nl, rest = msg.partition('\n')

        msg = term.error(first_line)+nl+rest

    sys.stderr.write(msg)

class ExTracker:

    def __init__(self):

        self.e_ct = 0

        def at_exit():

            sys.stderr.write(self.msg()+'\n')

            if self.e_ct > 0: raise SystemExit(e_ct_exit_status(self.e_ct))

        atexit.register(at_exit)

    def msg(self): return 'Encountered '+str(self.e_ct)+' error(s)'

    def track(self, e, **format):

        self.e_ct += 1

        print_ex(e, **format)

class ExPercentTracker(ExTracker):

    def __init__(self):

        ExTracker.__init__(self)

        self.iter_ct = None

    def add_iters(self, iter_ct):

        if self.iter_ct == None: self.iter_ct = 0

        self.iter_ct += iter_ct

    def msg(self):

        msg = ExTracker.msg(self)

        if self.iter_ct != None: msg += ('/'+str(self.iter_ct)+' iterations = '

            +util.to_percent(float(self.e_ct)/self.iter_ct))

        return msg