Source code for src.utils.errors

"""Custom exception hierarchy for Share of Search analysis."""




class ShareOfSearchError(Exception):
    """Base exception for all Share of Search errors."""
    pass





class ConfigurationError(ShareOfSearchError):
    """Configuration-related errors."""
    pass





class InvalidConfigError(ConfigurationError):
    """Invalid configuration provided."""
    pass





class MissingAPIKeyError(ConfigurationError):
    """Required API key not found."""
    pass





class DataError(ShareOfSearchError):
    """Data fetching/processing errors."""
    pass





class APIError(DataError):
    """API request failed."""
    pass





class RateLimitError(APIError):
    """API rate limit exceeded."""
    pass





class InvalidResponseError(APIError):
    """API returned invalid/unexpected response."""
    pass





class ProcessingError(ShareOfSearchError):
    """Data processing errors."""
    pass





class TransformError(ProcessingError):
    """Data transformation failed."""
    pass





class CalculationError(ProcessingError):
    """Metric calculation failed."""
    pass





class VisualizationError(ShareOfSearchError):
    """Visualization generation errors."""
    pass





class ReportError(ShareOfSearchError):
    """Report generation errors."""
    pass