Struct EclipseEngine 

pub struct EclipseEngine<B> { /* private fields */ }

Searches for global/geocentric eclipses over a chosen EphemerisBackend.

Backed by the packaged data, results are valid only within the 1900-01-01..2100-01-01 window (see crate); out-of-window requests fail closed with EclipseError::OutOfWindow.

Implementations

impl<B: EphemerisBackend> EclipseEngine<B>

pub fn new(backend: B) -> Self

Creates an engine that draws Sun/Moon positions from backend.

pub fn eclipses_in_range( &self, start: Instant, end: Instant, filter: EclipseFilter, ) -> Result<Vec<Eclipse>, EclipseError>

Returns every eclipse admitted by filter with greatest eclipse in [start, end], in chronological order. Fails closed if either bound is outside the supported window.

pub fn next_eclipse( &self, after: Instant, filter: EclipseFilter, ) -> Result<Option<Eclipse>, EclipseError>

Returns the first eclipse admitted by filter whose greatest eclipse is strictly after after, or None if none remains before the window end.

pub fn previous_eclipse( &self, before: Instant, filter: EclipseFilter, ) -> Result<Option<Eclipse>, EclipseError>

Returns the last eclipse admitted by filter whose greatest eclipse is strictly before before, or None if none exists after the window start.