exasol-error-reporting 0.4.0

Exasol Python Error Reporting

Exasol Error Reporting

This project contains a Python library for describing Exasol error messages. This library lets you define errors with a uniform set of attributes. Furthermore, the error message is implemented to be parseable, so that you can extract an error catalog from the code.

In a Nutshell

Install the library

pip install exasol-error-reporting

Create a Simple Error

from exasol import error

error1 = error.ExaError(
    "E-TEST-1", "A trivial error", "No mitigation available", {}
)

Specify Multiple Mitigations

from exasol import error

error2 = error.ExaError(
    "E-TEST-2",
    "Fire in the server room",
    [
        "Use the fire extinguisher",
        "Flood the room with halon gas (Attention: be sure no humans in the room!)"
    ],
    {}
)

Error Parameter(s) without description

from exasol import error

error3 = error.ExaError(
    "E-TEST-2",
    "Not enough space on device {{device}}.",
    "Delete something from {{device}}.",
    {"device": "/dev/sda1"},
)

Error with detailed Parameter(s)

from exasol import error
from exasol.error import Parameter

error4 = error.ExaError(
    "E-TEST-2",
    "Not enough space on device {{device}}.",
    "Delete something from {{device}}.",
    {"device": Parameter("/dev/sda1", "name of the device")},
)

Check out the user guide for more details.

Tooling

The exasol-error-reporting library comes with a command line tool (ec) which also can be invoked by using its package/module entry point (python -m exasol.error). For detailed information about the usage consider consulting the help ec --help or python -m exasol.error --help.

Parsing the error definitions in a python file(s)

ec parse some-python-file.py 

ec parse < some-python-file.py 

Generating an error-code data file

In order to generate a error-code-report compliant data file, you can use the generate subcommand.

ec generate NAME VERSION PACKAGE_ROOT > error-codes.json

Known Issues

• Throws exception on invalid error code format
• Single mitigations only can be passed within a list
• Named parameters do not work for error construction

Information for Users

• User Guide
• Changelog

You can find corresponding libraries for other languages here:

• Error reporting Java
• Error reporting Lua
• Error reporting Go
• Error reporting C#

Information for Contributors

• System Requirement Specification
• Design
• Dependencies