Struct PriceHistoryState 

pub struct PriceHistoryState { /* private fields */ }

Represents the current state of price history data in the database.

Tracks the time range of available price data, identifies gaps in the data, and determines what additional data needs to be fetched to achieve complete synchronization within a specified reach period.

Implementations

impl PriceHistoryState

pub async fn evaluate(db: &Database) -> Result<Self, SyncPriceHistoryError>

Evaluates the current price history state from the database.

Analyzes the database to determine data bounds and gaps without imposing a reach time limit.

pub fn bounds(&self) -> Option<(DateTime<Utc>, DateTime<Utc>)>

Returns the time bounds of the available price history data.

Returns None if the database is empty, otherwise returns a tuple of (earliest_time, latest_time).

pub fn gaps(&self) -> &Vec<(DateTime<Utc>, DateTime<Utc>)>

Returns the list of time gaps in the price history data.

Each gap is represented as a tuple of (from_time, to_time).

pub fn bound_start(&self) -> Option<DateTime<Utc>>

Returns the start time of the price history bounds.

pub fn bound_end(&self) -> Option<DateTime<Utc>>

Returns the end time of the price history bounds.

pub fn is_range_available( &self, range_from: DateTime<Utc>, range_to: DateTime<Utc>, ) -> Result<bool, SyncPriceHistoryError>

Checks if a specified time range is fully available without gaps.

pub fn tail_continuous_duration(&self) -> Option<Duration>

Returns the duration of continuous (gap-free) price history at the tail end.

This is the time span from the end of the most recent gap to the latest data point. If there are no gaps, returns the total duration of all available price history.

pub fn has_gaps(&self) -> Result<bool, SyncPriceHistoryError>

Checks whether there are any gaps or missing data within the reach period.

pub fn summary(&self) -> String

Generates a human-readable summary of the price history state.

Trait Implementations

impl Clone for PriceHistoryState

fn clone(&self) -> PriceHistoryState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PriceHistoryState

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

Formats the value using the given formatter.

impl Display for PriceHistoryState

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

Formats the value using the given formatter.

impl From<PriceHistoryState> for SyncUpdate

fn from(value: PriceHistoryState) -> Self

Converts to this type from the input type.

impl PartialEq for PriceHistoryState

fn eq(&self, other: &PriceHistoryState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PriceHistoryState

impl StructuralPartialEq for PriceHistoryState