Struct TrackerState 

pub struct TrackerState {
    pub current_event: TrackerEvent,
    pub last_announce_time: Option<Instant>,
    pub min_interval_secs: u64,
    pub interval_secs: u64,
    pub announce_count: u64,
    /* private fields */
}

State machine for tracking announce events and intervals.

Manages the current event state, timing of announces, and ensures proper event sequencing according to BitTorrent specification.

Fields

current_event: TrackerEvent

Current event to send on next announce

last_announce_time: Option<Instant>

Timestamp of last successful announce

min_interval_secs: u64

Minimum interval between announces (from tracker response)

interval_secs: u64

Normal interval between announces (from tracker response)

announce_count: u64

Total number of announces sent

Implementations

impl TrackerState

pub fn new() -> Self

Create a new tracker state with default values

pub fn should_announce(&self) -> bool

Check if it’s time to send another announce based on interval constraints

Returns true if enough time has elapsed since the last announce according to min_interval_secs

pub fn secs_until_next_announce(&self) -> u64

Get the recommended wait time until next announce

pub fn record_announce(&mut self, event: TrackerEvent)

Mark that an announce has been sent and advance the event state

This updates internal timing and transitions the event state:

• After Started -> None (for regular announces)
• After Completed -> None
• After Stopped -> stays Stopped (terminal state)

pub fn update_intervals( &mut self, interval: Option<u64>, min_interval: Option<u64>, )

Update interval values from tracker response

Trackers return interval (recommended) and optionally min interval which constrain how often we may re-announce.

pub fn mark_completed(&mut self)

Transition to completed state - call when all pieces are downloaded

pub fn mark_stopped(&mut self)

Transition to stopped state - call on shutdown/cancel

pub fn reset(&mut self)

Reset state for a new download session

pub fn is_stopped(&self) -> bool

Check if the tracker is in terminal (stopped) state

Trait Implementations

impl Debug for TrackerState

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

Formats the value using the given formatter.

impl Default for TrackerState

fn default() -> Self

Returns the “default value” for a type.