Enum AstroError 

pub enum AstroError {
    InvalidDate {
        year: i32,
        month: i32,
        day: i32,
        message: String,
    },
    MathError {
        operation: String,
        kind: MathErrorKind,
        message: String,
    },
    ExternalLibraryError {
        function: String,
        status_code: i32,
        message: String,
    },
    DataError {
        file_type: String,
        operation: String,
        message: String,
    },
    CalculationError {
        context: String,
        message: String,
    },
}

Unified error type for astronomical calculations.

Covers calendar validation, numerical issues, external dependencies, data access, and algorithmic failures. Use the constructor methods (invalid_date, math_error, etc.) for consistent error creation.

Variants

InvalidDate

Invalid calendar date (e.g., February 30, month 13).

Fields

year: i32

month: i32

day: i32

message: String

MathError

Numerical computation failure.

Fields

operation: String

kind: MathErrorKind

message: String

ExternalLibraryError

Failure in external library or hardware driver.

Fields

function: String

status_code: i32

message: String

DataError

Data access failure (file I/O, network, parsing).

This is the only recoverable error variant — retry or fallback may succeed.

Fields

file_type: String

operation: String

message: String

CalculationError

Algorithm or calculation failure.

Fields

context: String

message: String

Implementations

impl AstroError

pub fn invalid_date(year: i32, month: i32, day: i32, reason: &str) -> Self

Creates an InvalidDate error.

pub fn math_error(operation: &str, kind: MathErrorKind, reason: &str) -> Self

Creates a MathError with the given kind.

pub fn external_library_error( function: &str, status_code: i32, message: &str, ) -> Self

Creates an ExternalLibraryError.

pub fn data_error(file_type: &str, operation: &str, reason: &str) -> Self

Creates a DataError (the only recoverable variant).

pub fn calculation_error(context: &str, reason: &str) -> Self

Creates a CalculationError.

pub fn is_recoverable(&self) -> bool

Returns true if retrying or using a fallback might succeed.

Only DataError is recoverable (network retry, alternate source).

Trait Implementations

impl Debug for AstroError

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

Formats the value using the given formatter.

impl Display for AstroError

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

Formats the value using the given formatter.

impl Error for AstroError

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.