Struct HistoryOptions

pub struct HistoryOptions {
    pub start_index: Option<u16>,
    pub end_index: Option<u16>,
    pub read_delay: Duration,
    pub progress_callback: Option<ProgressCallback>,
}

Options for downloading history.

Index Convention

Indices are 1-based to match the Aranet device protocol:

• start_index: Some(1) means the first (oldest) reading
• end_index: Some(100) means the 100th reading
• start_index: None defaults to 1 (beginning)
• end_index: None defaults to total_readings (end)

Progress Reporting

Use with_progress to receive updates during download:

let options = HistoryOptions::default()
    .with_progress(|p| println!("Progress: {:.1}%", p.overall_progress * 100.0));

Fields

start_index: Option<u16>

Starting index (1-based, inclusive). If None, downloads from the beginning (index 1).

end_index: Option<u16>

Ending index (1-based, inclusive). If None, downloads to the end (index = total_readings).

read_delay: Duration

Delay between read operations to avoid overwhelming the device.

progress_callback: Option<ProgressCallback>

Progress callback (optional).

Implementations

impl HistoryOptions

pub fn new() -> Self

Create new history options with default settings.

pub fn start_index(self, index: u16) -> Self

Set the starting index (1-based).

pub fn end_index(self, index: u16) -> Self

Set the ending index (1-based).

pub fn read_delay(self, delay: Duration) -> Self

Set the delay between read operations.

pub fn with_progress<F>(self, callback: F) -> Self

where F: Fn(HistoryProgress) + Send + Sync + 'static,

Set a progress callback.

pub fn report_progress(&self, progress: &HistoryProgress)

Report progress if a callback is set.

Trait Implementations

impl Clone for HistoryOptions

fn clone(&self) -> HistoryOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HistoryOptions

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

Formats the value using the given formatter.

impl Default for HistoryOptions

fn default() -> Self

Returns the “default value” for a type.