exasol-error-reporting

What it is and what it does

exasol-error-reporting is a Python library for defining and managing Exasol database error messages with a consistent structure. It lets you create error objects with an error code, message text, mitigation steps, and typed parameters, then extract and document those errors programmatically. The library includes a command-line tool (ec) that parses Python source files to find error definitions and generates error-code reports in a standardized JSON format.

It's designed for teams building Exasol integrations or extensions who need to maintain a uniform error catalog across their codebase. The library has no runtime dependencies, installs easily, and supports modern Python versions (3.10 through 3.14). It's actively maintained and carries an MIT license.

Use it for:

• Generate a machine-readable error catalog from error definitions scattered across your Python codebase.
• Define errors with consistent structure (code, message, mitigations, parameters) for Exasol database tools.
• Extract and validate error codes and messages for documentation or error-handling automation.
• Parameterize error messages with typed metadata for better error reporting and debugging.
• Build error documentation automatically from inline error definitions in source code.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Defines and structures Exasol error messages with uniform attributes, parameters, and mitigations, and provides tooling to parse and extract error catalogs from Python code.

Yes. The package solves a specific, well-defined problem (structured Exasol error reporting) with zero runtime dependencies, active maintenance, permissive licensing, and no known vulnerabilities. Install it if you're building Exasol integrations or need to maintain a consistent error catalog; skip it if you don't use Exasol or don't need structured error management.

Install

exasol-error-reporting on PyPI

pip install exasol-error-reporting

uv add exasol-error-reporting

poetry add exasol-error-reporting

Installing exasol-error-reporting

Before you install

Low install friction with no runtime dependencies. Actively maintained as of 2026-08-10 with regular releases.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions.

Quickstart

pip install exasol-error-reporting

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

Requires Python 3.10 or later (supports 3.10 through 3.14).

Verify before relying

• Whether the error catalog extraction and JSON generation features work reliably in production workflows.
• Performance characteristics when parsing large Python files or codebases with many error definitions.

Package facts

Evidence: exasol_error_reporting-1.1.0-py3-none-any.whl

Keywords: exasol, python, error-reporting

Tags

More Software Development packages