Error Handling Reference

Complete reference for error classes and error handling utilities.

Error Classes

APIError

Base error class for all API errors.

class honeyhive.utils.error_handler.APIError(message, error_response=None, original_exception=None)

Bases: HoneyHiveError

API-related errors.

Parameters:

• message (str)

• error_response (ErrorResponse | None)

• original_exception (Exception | None)

AuthenticationError

class honeyhive.utils.error_handler.AuthenticationError(message, error_response=None, original_exception=None)

Bases: HoneyHiveError

Authentication and authorization errors.

Parameters:

• message (str)

• error_response (ErrorResponse | None)

• original_exception (Exception | None)

ValidationError

class honeyhive.utils.error_handler.ValidationError(message, error_response=None, original_exception=None)

Bases: HoneyHiveError

Data validation errors.

Parameters:

• message (str)

• error_response (ErrorResponse | None)

• original_exception (Exception | None)

RateLimitError

class honeyhive.utils.error_handler.RateLimitError(message, error_response=None, original_exception=None)

Bases: HoneyHiveError

Rate limiting errors.

Parameters:

• message (str)

• error_response (ErrorResponse | None)

• original_exception (Exception | None)

Error Handler

ErrorHandler

class honeyhive.utils.error_handler.ErrorHandler(logger_name='honeyhive.error_handler')

Bases: object

Standardized error handling middleware.

This class provides a single public method for error handling, which is appropriate for its focused responsibility.

Parameters:

logger_name (str)

handle_operation(context, raise_on_error=True, return_error_response=False)

Context manager for handling operations with standardized error handling.

Parameters:

• context (ErrorContext) – Error context information

• raise_on_error (bool) – Whether to raise exceptions or return error responses

• return_error_response (bool) – Whether to return ErrorResponse objects instead of raising

Yields:

None

Raises:

HoneyHiveError – If raise_on_error is True and an error occurs

Return type:

Generator[None, None, None]

ErrorContext

class honeyhive.utils.error_handler.ErrorContext(operation, method=None, url=None, params=None, json_data=None, client_name=None, additional_context=<factory>)

Bases: object

Context information for error handling.

Parameters:

• operation (str)

• method (str | None)

• url (str | None)

• params (Dict[str, Any] | None)

• json_data (Dict[str, Any] | None)

• client_name (str | None)

• additional_context (Dict[str, Any])

operation: str

method: str | None = None

url: str | None = None

params: Dict[str, Any] | None = None

json_data: Dict[str, Any] | None = None

client_name: str | None = None

additional_context: Dict[str, Any]

ErrorResponse

class honeyhive.utils.error_handler.ErrorResponse(success=False, error_type='UnknownError', error_message='An unknown error occurred', error_code=None, status_code=None, details=None, context=None, retry_after=None)

Bases: object

Standardized error response.

Parameters:

• success (bool)

• error_type (str)

• error_message (str)

• error_code (str | None)

• status_code (int | None)

• details (Dict[str, Any] | None)

• context (ErrorContext | None)

• retry_after (float | None)

success: bool = False

error_type: str = 'UnknownError'

error_message: str = 'An unknown error occurred'

error_code: str | None = None

status_code: int | None = None

details: Dict[str, Any] | None = None

context: ErrorContext | None = None

retry_after: float | None = None

to_dict()

Convert error response to dictionary.

Return type:

Dict[str, Any]

Tracer Integration Errors

InitializationError

class honeyhive.tracer.integration.error_handling.InitializationError(message, cause=None)

Bases: IntegrationError

Error during tracer initialization.

Parameters:

• message (str)

• cause (Exception | None)

ExportError

class honeyhive.tracer.integration.error_handling.ExportError(export_type, cause=None)

Bases: IntegrationError

Error during span export.

Parameters:

• export_type (str)

• cause (Exception | None)

ErrorSeverity

class honeyhive.tracer.integration.error_handling.ErrorSeverity(value)

Bases: Enum

Error severity levels for dynamic handling.

LOW = 'low'

MEDIUM = 'medium'

HIGH = 'high'

CRITICAL = 'critical'

ResilienceLevel

class honeyhive.tracer.integration.error_handling.ResilienceLevel(value)

Bases: Enum

Resilience levels for dynamic error handling strategies.

STRICT = 'strict'

BALANCED = 'balanced'

RESILIENT = 'resilient'

See Also

• API Client Classes - API client reference

• HoneyHiveTracer API Reference - Tracer API