# EMACS settings: -*- tab-width: 2; indent-tabs-mode: t; python-indent-offset: 2 -*-
# vim: tabstop=2:shiftwidth=2:noexpandtab
# kate: tab-width 2; replace-tabs off; indent-width 2;
#
# ==============================================================================
# Authors: Patrick Lehmann
# Thomas B. Preusser
#
# Python functions: Auxillary functions to exit a program and report an error message.
#
# License:
# ==============================================================================
# Copyright 2007-2016 Technische Universitaet Dresden - Germany
# Chair of VLSI-Design, Diagnostics and Architecture
#
# 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.
# ==============================================================================
#
# load dependencies
from functools import reduce
from operator import or_
from sys import version_info
__api__ = [
'merge', 'merge_with',
'CallByRefParam',
'Init',
'Exit'
]
__all__ = __api__
[docs]def merge(*dicts):
"""Merge 2 or more dictionaries."""
return {k : reduce(lambda d,x: x.get(k, d), dicts, None) for k in reduce(or_, map(lambda x: x.keys(), dicts), set()) }
[docs]def merge_with(f, *dicts):
"""Merge 2 or more dictionaries. Apply function f to each element during merge."""
return {k : reduce(lambda x: f(*x) if (len(x) > 1) else x[0])([ d[k] for d in dicts if k in d ]) for k in reduce(or_, map(lambda x: x.keys(), dicts), set()) }
[docs]class CallByRefParam:
"""Implements a "call by reference" parameter.
.. seealso::
:py:class:`CallByRefBoolParam`
A special "call by reference" implementation for boolean reference types.
:py:class:`CallByRefIntParam`
A special "call by reference" implementation for integer reference types.
"""
def __init__(self, value=None):
self.value = value
def __ilshift__(self, other):
self.value = other
return self
def __eq__(self, other): return self.value == other
def __ne__(self, other): return self.value != other
def __repr__(self): return repr(self.value)
def __str__(self): return str(self.value)
class CallByRefBoolParam(CallByRefParam):
"""A special "call by reference" implementation for boolean reference types."""
# unary operators
def __neg__(self): return not self.value
# binary operators - logical
def __and__(self, other): return self.value and other
def __or__(self, other): return self.value or other
# binary inplace operators
def __iand__(self, other):
self.value = self.value and other
return self
def __ior__(self, other):
self.value = self.value or other
return self
# type conversion operators
def __bool__(self): return self.value
def __int__(self): return int(self.value)
class CallByRefIntParam(CallByRefParam):
"""A special "call by reference" implementation for integer reference types."""
# unary operators
def __neg__(self): return not self.value
# binary operators - arithmetic
def __add__(self, other): return self.value + other
def __sub__(self, other): return self.value - other
def __truediv__(self, other): return self.value / other
def __mul__(self, other): return self.value * other
def __mod__(self, other): return self.value % other
def __pow__(self, other): return self.value ** other
# binary operators - comparison
def __eq__(self, other): return self.value == other
def __ne__(self, other): return self.value != other
def __lt__(self, other): return self.value < other
def __le__(self, other): return self.value <= other
def __gt__(self, other): return self.value > other
def __ge__(self, other): return self.value >= other
# type conversion operators
def __bool__(self): return bool(self.value)
def __int__(self): return self.value
[docs]class Init:
@classmethod
[docs] def init(cls):
from colorama import init, Back as Background
init()#strip=False)
print(Background.BLACK, end="")
from colorama import Fore as Foreground
Foreground = {
"RED": Foreground.LIGHTRED_EX,
"DARK_RED": Foreground.RED,
"GREEN": Foreground.LIGHTGREEN_EX,
"DARK_GREEN": Foreground.GREEN,
"YELLOW": Foreground.LIGHTYELLOW_EX,
"DARK_YELLOW": Foreground.YELLOW,
"MAGENTA": Foreground.LIGHTMAGENTA_EX,
"BLUE": Foreground.LIGHTBLUE_EX,
"CYAN": Foreground.LIGHTCYAN_EX,
"DARK_CYAN": Foreground.CYAN,
"GRAY": Foreground.WHITE,
"DARK_GRAY": Foreground.LIGHTBLACK_EX,
"WHITE": Foreground.LIGHTWHITE_EX,
"NOCOLOR": Foreground.RESET,
"HEADLINE": Foreground.LIGHTMAGENTA_EX,
"ERROR": Foreground.LIGHTRED_EX,
"WARNING": Foreground.LIGHTYELLOW_EX
}
[docs]class Exit:
@classmethod
[docs] def exit(cls, returnCode=0):
from colorama import Fore as Foreground, Back as Background, Style
print(Foreground.RESET + Background.RESET + Style.RESET_ALL, end="")
exit(returnCode)
@classmethod
[docs] def versionCheck(cls, version):
if (version_info < version):
Init.init()
print("{RED}ERROR:{NOCOLOR} Used Python interpreter is to old ({version}).".format(version=version_info, **Init.Foreground))
print(" Minimal required Python version is {version}".format(version=".".join(version)))
cls.exit(1)
@classmethod
[docs] def printException(cls, ex):
from traceback import print_tb, walk_tb
Init.init()
print("{RED}FATAL: An unknown or unhandled exception reached the topmost exception handler!{NOCOLOR}".format(**Init.Foreground))
print("{YELLOW} Exception type:{NOCOLOR} {typename}".format(typename=ex.__class__.__name__, **Init.Foreground))
print("{YELLOW} Exception message:{NOCOLOR} {message!s}".format(message=ex, **Init.Foreground))
frame,sourceLine = [x for x in walk_tb(ex.__traceback__)][-1]
filename = frame.f_code.co_filename
funcName = frame.f_code.co_name
print("{YELLOW} Caused in:{NOCOLOR} {function} in file '{filename}' at line {line}".format(function=funcName, filename=filename, line=sourceLine, **Init.Foreground))
if (ex.__cause__ is not None):
print("{DARK_YELLOW} Caused by type:{NOCOLOR} {typename}".format(typename=ex.__cause__.__class__.__name__, **Init.Foreground))
print("{DARK_YELLOW} Caused by message:{NOCOLOR} {message!s}".format(message=ex.__cause__, **Init.Foreground))
print(("{RED}" + ("-" * 80) + "{NOCOLOR}").format(**Init.Foreground))
print_tb(ex.__traceback__)
print(("{RED}" + ("-" * 80) + "{NOCOLOR}").format(**Init.Foreground))
print(("{RED}Please report this bug at GitHub: https://github.com/VLSI-EDA/PoC/issues{NOCOLOR}").format(**Init.Foreground))
print(("{RED}" + ("-" * 80) + "{NOCOLOR}").format(**Init.Foreground))
Exit.exit(1)
@classmethod
[docs] def printNotImplementedError(cls, ex):
from traceback import walk_tb
Init.init()
frame, _ = [x for x in walk_tb(ex.__traceback__)][-1]
filename = frame.f_code.co_filename
funcName = frame.f_code.co_name
print("{RED}NOT IMPLEMENTED:{NOCOLOR} {function} in file '{filename}': {message!s}".format(function=funcName, filename=filename, message=ex, **Init.Foreground))
print(("{RED}" + ("-" * 80) + "{NOCOLOR}").format(**Init.Foreground))
print(("{RED}Please report this bug at GitHub: https://github.com/VLSI-EDA/PoC/issues{NOCOLOR}").format(**Init.Foreground))
print(("{RED}" + ("-" * 80) + "{NOCOLOR}").format(**Init.Foreground))
Exit.exit(1)
@classmethod
[docs] def printExceptionBase(cls, ex):
Init.init()
print("{RED}FATAL: A known but unhandled exception reached the topmost exception handler!{NOCOLOR}".format(**Init.Foreground))
print("{RED}ERROR:{NOCOLOR} {message}".format(message=ex.message, **Init.Foreground))
print(("{RED}" + ("-" * 80) + "{NOCOLOR}").format(**Init.Foreground))
print(("{RED}Please report this bug at GitHub: https://github.com/VLSI-EDA/PoC/issues{NOCOLOR}").format(**Init.Foreground))
print(("{RED}" + ("-" * 80) + "{NOCOLOR}").format(**Init.Foreground))
Exit.exit(1)
@classmethod
@classmethod
[docs] def printEnvironmentException(cls, ex):
Init.init()
print("{RED}ERROR:{NOCOLOR} {message}".format(message=ex.message, **Init.Foreground))
print(" Please run this script with it's provided wrapper ('poc.[sh/ps1]') or manually load the required environment before executing this script.")
Exit.exit(1)
@classmethod