{"id":9728,"library":"exasol-error-reporting","title":"Exasol Error Reporting","description":"Exasol Error Reporting is a Python library designed to standardize error messages with structured error codes, messages, and mitigation hints. It ensures uniformity across applications by enforcing a specific error code format. The current version is 1.1.0, and it follows an active release cadence, typically updating dependencies and addressing security concerns as needed.","status":"active","version":"1.1.0","language":"python","source_language":"en","source_url":"https://github.com/exasol/error-reporting-python","tags":["error reporting","exasol","logging","exceptions","developer tools"],"install":[{"cmd":"pip install exasol-error-reporting","lang":"bash","label":"Install latest version"}],"dependencies":[],"imports":[{"wrong":"from exasol.error_reporting import ExaError","symbol":"ExaError","correct":"from exasol.error_reporting import ExaError"}],"quickstart":{"code":"from exasol.error_reporting import ExaError\n\ndef my_faulty_function(param_value):\n    if param_value is None:\n        raise ExaError(\"E-TEST-1\", \"Input parameter 'param_value' must not be None.\") \\\n            .add_mitigation(\"Provide a valid non-null value for 'param_value'.\") \\\n            .add_parameter(\"received_value\", \"None\")\n    return f\"Processed: {param_value}\"\n\n# Example Usage:\ntry:\n    my_faulty_function(None)\nexcept ExaError as e:\n    print(f\"Caught ExaError: {e.error_code} - {e.message}\")\n    for mitigation in e.mitigations:\n        print(f\"  Mitigation: {mitigation}\")\n    for param, value in e.parameters.items():\n        print(f\"  Parameter {param}: {value}\")\n\ntry:\n    result = my_faulty_function(\"hello\")\n    print(result)\nexcept ExaError as e:\n    print(f\"Unexpected error: {e}\")","lang":"python","description":"This quickstart demonstrates how to define and raise an `ExaError` with a structured error code, message, mitigation hints, and additional parameters. It also shows how to catch and inspect the `ExaError` object."},"warnings":[{"fix":"Upgrade your Python environment to 3.10 or newer. The library requires Python >=3.10, <4.0.","message":"Python 3.9 support was dropped.","severity":"breaking","affected_versions":">=1.1.0"},{"fix":"Update your `pip install` command and all import statements from `exasol_error_reporting_python` to `exasol.error_reporting`.","message":"The package name and import path changed from `exasol-error-reporting-python` to `exasol-error-reporting`.","severity":"breaking","affected_versions":">=0.4.0"},{"fix":"Ensure error codes follow the pattern `E-<THREE_LETTER_COMPONENT>-<NUMBER>`, where `E` is fixed, the component is three uppercase letters, and the number is an integer.","message":"Error codes must adhere to a specific format (e.g., `E-ABC-1`). Incorrect formats will raise a `ValueError`.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.1.0':40 'across':27 'activ':45 'address':52 'applic':28 'cadenc':47 'code':19,34 'concern':54 'current':37 'depend':50 'design':11 'develop':62 'enforc':30 'ensur':25 'error':2,5,14,18,33,57 'exasol':1,4,59 'except':61 'follow':43 'format':35 'hint':23 'librari':10 'log':60 'messag':15,20 'mitig':22 'need':56 'python':9 'releas':46 'report':3,6,58 'secur':53 'specif':32 'standard':13 'structur':17 'tool':63 'typic':48 'uniform':26 'updat':49 'version':38","created_at":"2026-04-17T01:20:24.971928+00:00","updated_at":"2026-04-17T01:20:24.971928+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nModuleNotFoundError: No module named 'exasol.error_reporting'"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.1.0","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/exasol/error-reporting-python","docs":null,"changelog":null,"pypi":"https://pypi.org/project/exasol-error-reporting/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["serialization"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}