use std::path::{Path, PathBuf};
const DEFAULT_MAX_AGE_SECS: u64 = 4 * 60 * 60;
#[must_use]
pub fn path_from_env() -> Option<PathBuf> {
let root = std::env::var("SHANTY_ROOT").ok()?;
let agent = std::env::var("SHANTY_AGENT").ok()?;
if root.is_empty() || agent.is_empty() {
return None;
}
Some(Path::new(&root).join("crew").join(agent).join("plate.json"))
}
#[must_use]
pub fn parse(doc: &str, now: u64, max_age: u64) -> Option<String> {
let v: serde_json::Value = serde_json::from_str(doc).ok()?;
let item = v.get("item")?.as_str()?;
if item.is_empty() {
return None;
}
let at = v.get("at")?.as_u64()?;
if now.saturating_sub(at) > max_age {
return None;
}
Some(item.to_string())
}
#[must_use]
pub fn current() -> Option<String> {
let path = path_from_env()?;
let doc = std::fs::read_to_string(path).ok()?;
let now = std::time::SystemTime::now()
.duration_since(std::time::UNIX_EPOCH)
.map_or(0, |d| d.as_secs());
let max_age = std::env::var("HANK_PLATE_MAX_AGE_SECS")
.ok()
.and_then(|s| s.parse::<u64>().ok())
.unwrap_or(DEFAULT_MAX_AGE_SECS);
parse(&doc, now, max_age)
}
#[cfg(test)]
mod tests {
use super::*;
const NOW: u64 = 1_000_000;
const MAX: u64 = 3600;
fn doc(item: &str, at: u64) -> String {
format!(r#"{{"item":"{item}","at":{at},"session":null}}"#)
}
#[test]
fn reads_a_fresh_plate() {
assert_eq!(
parse(&doc("abc-1", NOW), NOW, MAX).as_deref(),
Some("abc-1")
);
}
#[test]
fn stale_is_unknown_and_fresh_is_not() {
assert_eq!(parse(&doc("abc-2", NOW - MAX - 1), NOW, MAX), None);
assert_eq!(
parse(&doc("abc-2", NOW - MAX + 1), NOW, MAX).as_deref(),
Some("abc-2")
);
}
#[test]
fn boundary_is_inclusive_at_exactly_max_age() {
assert_eq!(
parse(&doc("abc-3", NOW - MAX), NOW, MAX).as_deref(),
Some("abc-3")
);
}
#[test]
fn empty_plate_is_unknown() {
assert_eq!(parse(r#"{"item":null,"at":1000000}"#, NOW, MAX), None);
assert_eq!(parse(&doc("", NOW), NOW, MAX), None);
}
#[test]
fn malformed_is_unknown_and_never_treated_as_fresh() {
assert_eq!(parse("{not json", NOW, MAX), None);
assert_eq!(parse("[]", NOW, MAX), None);
assert_eq!(parse(r#"{"item":42,"at":1000000}"#, NOW, MAX), None);
assert_eq!(parse(r#"{"item":"abc-4"}"#, NOW, MAX), None);
assert_eq!(parse(r#"{"item":"abc-4","at":"soon"}"#, NOW, MAX), None);
}
#[test]
fn a_clock_that_went_backwards_does_not_reject_everything() {
assert_eq!(
parse(&doc("abc-5", NOW + 500), NOW, MAX).as_deref(),
Some("abc-5")
);
}
}