use std::time::Duration;
use tokio::time::Instant;
pub(super) const ACTIVE_SHARE: u32 = 3;
const RUNNERS_EVERY: u8 = 3;
#[derive(Debug, Default)]
pub(super) struct ListingPace {
began: Option<Instant>,
runners: RunnersDue,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
enum RunnersDue {
#[default]
Owed,
After(u8),
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(super) enum Runners {
ByTurn,
Now,
}
impl ListingPace {
pub(super) fn due(&self, every: Duration) -> Option<Instant> {
self.began.map(|began| began + every)
}
pub(super) fn is_due(&self, now: Instant, every: Duration) -> bool {
self.due(every).is_none_or(|due| due <= now)
}
pub(super) fn begin(&mut self, at: Instant, runners: Runners) -> bool {
self.began = Some(at);
let lists = match (runners, self.runners) {
(Runners::Now, _) | (Runners::ByTurn, RunnersDue::Owed | RunnersDue::After(0)) => true,
(Runners::ByTurn, RunnersDue::After(_)) => false,
};
self.runners = match self.runners {
_ if lists => RunnersDue::After(RUNNERS_EVERY - 1),
RunnersDue::After(left) => RunnersDue::After(left.saturating_sub(1)),
RunnersDue::Owed => RunnersDue::Owed,
};
lists
}
pub(super) fn runners_owed(&mut self) {
self.runners = RunnersDue::Owed;
}
}
#[cfg(test)]
impl ListingPace {
pub(super) fn age(&mut self, by: Duration) {
self.began = self.began.and_then(|began| began.checked_sub(by));
}
}
#[cfg(test)]
mod tests {
use super::*;
const EVERY: Duration = Duration::from_secs(5);
#[tokio::test(start_paused = true)]
async fn a_repository_never_listed_is_due_and_lists_its_runners() {
let mut pace = ListingPace::default();
let now = Instant::now();
assert!(pace.is_due(now, EVERY), "never listed is due");
assert!(
pace.begin(now, Runners::ByTurn),
"the first probe lists runners"
);
assert!(!pace.is_due(now, EVERY), "just listed");
assert!(
pace.is_due(now + EVERY, EVERY),
"due an interval after it began"
);
}
#[tokio::test(start_paused = true)]
async fn runners_are_listed_every_third_probe_unless_owed_or_asked() {
let mut pace = ListingPace::default();
let now = Instant::now();
let probes: Vec<bool> = (0..7).map(|_| pace.begin(now, Runners::ByTurn)).collect();
assert_eq!(probes, [true, false, false, true, false, false, true]);
pace.begin(now, Runners::ByTurn);
pace.runners_owed();
assert!(
pace.begin(now, Runners::ByTurn),
"owed after a start lists them"
);
assert!(
!pace.begin(now, Runners::ByTurn),
"and counts again from there"
);
assert!(pace.begin(now, Runners::Now), "a command's tick lists them");
assert!(
!pace.begin(now, Runners::ByTurn),
"which counts as their turn"
);
}
}