Skip to main content

As the python exception API is quite a bit obscure this python module wraps around python exceptions to provide a clean interface for analysis and logging purposes.

Project description

jk_exceptionhelper

Introduction

This python module wraps around python exceptions. As the python exception API is quite a bit obscure this python module provides a clean API for analysis and logging purposes.

Information about this module can be found here:

Why this module?

As the python exception API is quite a bit obscure this python module tries to solve this problem. By focusing on this problem in an isolated way improvements can easily be made without breaking and adapting a variety of implementations.

How to use this module

Import this module

Please include this module into your application using the following code:

import jk_exceptionhelper

Analyse the exeption

Example:

try:
	a = 0
	b = 5 / a
except Exception as ex:
	ee = jk_exceptionhelper.analyseException(ex)

Now ee contains an instance of ExceptionObject. ExceptionObject contains all relevant information from the exception for your convenience to work with. (For details about the ExceptionObject API see below.)

Output the exception data

Example:

try:
	a = 0
	b = 5 / a
except Exception as ex:
	jk_exceptionhelper.analyseException(ex).dump()

This will print all data collected to STDOUT. Example:

ZeroDivisionError
: exceptionTextHR:
:	division by zero
: stackTrace:
:	(<stdin>:3, '')
\-

API: Functions

Function analyseException()

ExceptionObject analyseException()

This function should be called at the first statement within an except block. It returns an object of type ExceptionObject containing all relevant information from the exception for your convenience to work with.

API: Classes

Class 'ExceptionObject'

Fields

Type Name Required? Description
class exceptionClass optional The original exception class. This instance will only be present if analyseException() was called within an except block.
str exceptionClassName required The class name of the exception.
str exceptionTextHR optional A human readable text that was contained within the exception.
StackTraceItem[] stackTrace optional The stack trace. The last item of the list is the topmost stack element.
ExceptionObject nestedException optional The parent exception object if this exception has been caught in an except block.

Static Methods

Static Method StackTraceItem fromJSON(dict data)

StackTraceItem fromJSON(dict data)

Deserialize a data structure created by toJSON().

Methods

Method void dump()

void dump()

Print the contents of the exception to STDOUT.

Example:

try:
	a = 0
	b = 5 / a
except:
	analyseException().dump()

This will print something like this:

ZeroDivisionError
: exceptionTextHR:
:	division by zero
: stackTrace:
:	(./test2.py:55, 'b = 5 / a')
:	(./test2.py:59, 'main3()')
:	(./test2.py:63, 'main2()')
:	(./test2.py:67, 'main1()')

Method dict toJSON(bool bRecursive = True)

dict toJSON(bool bRecursive = True)

Serialize the exception object to JSON format.

Arguments:

  • bool bRecursive : If True (which is the default) nested exceptions are serialized as well. If False these get skipped.

Example:

try:
	a = 0
	b = 5 / a
except:
	edata = analyseException().toJSON()

Method dict toJSON(bool bRecursive = True)

dict toJSON_flat()

Same as toJSON(False).

Arguments:

  • (none)

Contact Information

This is Open Source code. That not only gives you the possibility of freely using this code it also allows you to contribute. Feel free to contact the author(s) of this software listed below, either for comments, collaboration requests, suggestions for improvement or reporting bugs:

License

This software is provided under the following license:

  • Apache Software License 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for jk-exceptionhelper, version 0.2020.3.4
Filename, size File type Python version Upload date Hashes
Filename, size jk_exceptionhelper-0.2020.3.4.tar.gz (9.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page