fattrace 0.0.3

Informative Stacktrace that shows everything on the stack

Fattrace

Provides an informative (fat) stacktrace that shows everything on the stack.

Examples

Before:

After:

Highlights

• Removes the need for printf and debugger
• Special handling for array-like objects which have members that are named one of:
  • dtype
  • shape
  • device
  • layout
• Similar to tbvaccine, optionally ignores frames from external libraries

Usage

Run fattrace.install() anywhere to replace the standard stack-trace hook (sys.excepthook).

Customization is done by the keyword arguments:

def install(threshold:int=3,
            include_self:bool=True,
            include_private:bool=False,
            include_external:bool=False,
            ignore:set[str]={},
            ignore_type:set[type]={},
            ):
    ...

• threshold : the maximum number of elements to print in a list, tuple, dict, etc.
• include_self : in a method call, whether to print the members of self.
• include_private : If true, private variables and members whose names start with "__" are excluded from the trace.
• include_external : if false (default), include assignments only if the code is under the current directory.
• ignore : A set of strings. Variables and members matching any of the names are excluded from the trace.
• ignore_type : A set of types. Variables and members matching any of the types are excluded from the trace.

License

MIT