Enum AppError 

pub enum AppError {
    DatabaseError(Error),
    ClientError(String),
    GeminiError(GeminiErrorDetails),
    SerializationError(Error),
    InvalidUrl(String),
    DatasetNotFound(String),
    InvalidPortalUrl(String),
    EmptyResponse,
    NetworkError(String),
    Timeout(u64),
    RateLimitExceeded,
    ConfigError(String),
    Generic(String),
}

Variants

DatabaseError(Error)

Database operation failed.

This error wraps all errors from SQLx database operations, including connection failures, query errors, and constraint violations.

ClientError(String)

HTTP client request failed.

This error occurs when HTTP requests fail due to network issues, timeouts, or server errors.

GeminiError(GeminiErrorDetails)

Gemini API call failed.

This error occurs when Gemini API calls fail, including authentication failures, rate limiting, and API errors. Contains structured error information for better error handling.

SerializationError(Error)

JSON serialization or deserialization failed.

This error occurs when converting between Rust types and JSON, typically when parsing API responses or preparing database values.

InvalidUrl(String)

URL parsing failed.

This error occurs when attempting to parse an invalid URL string, typically when constructing API endpoints or validating portal URLs.

DatasetNotFound(String)

Dataset not found in the database.

This error indicates that a requested dataset does not exist.

InvalidPortalUrl(String)

Invalid CKAN portal URL provided.

This error occurs when the provided CKAN portal URL is malformed or cannot be used to construct valid API endpoints.

EmptyResponse

API response contained no data.

This error occurs when an API returns a successful status but the response body is empty or missing expected data.

NetworkError(String)

Network or connection error.

This error occurs when a network request fails due to connectivity issues, DNS resolution failures, or the remote server being unreachable.

Timeout(u64)

Request timeout.

This error occurs when a request takes longer than the configured timeout.

RateLimitExceeded

Rate limit exceeded.

This error occurs when too many requests are made in a short period.

ConfigError(String)

Configuration file error.

This error occurs when reading or parsing the configuration file fails, such as when the portals.toml file is malformed or contains invalid values.

Generic(String)

Generic application error for cases not covered by specific variants.

Use this sparingly - prefer creating specific error variants for better error handling and debugging.

Implementations

impl AppError

pub fn user_message(&self) -> String

Returns a user-friendly error message suitable for CLI output.

pub fn is_retryable(&self) -> bool

Returns true if this error is retryable.

Examples

use ceres_core::error::AppError;

// Network errors are retryable
let err = AppError::NetworkError("connection reset".to_string());
assert!(err.is_retryable());

// Rate limits are retryable (after a delay)
let err = AppError::RateLimitExceeded;
assert!(err.is_retryable());

// Dataset not found is NOT retryable
let err = AppError::DatasetNotFound("test".to_string());
assert!(!err.is_retryable());

Trait Implementations

impl Debug for AppError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for AppError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for AppError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for AppError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AppError

fn from(source: Error) -> Self

Converts to this type from the input type.