use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
pub const PROTOCOL_VERSION: u32 = 1;
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(tag = "kind", rename_all = "snake_case")]
pub enum Request {
Status,
Start,
Stop,
Kill,
}
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(tag = "kind", rename_all = "snake_case")]
pub enum Response {
Status(StatusReply),
Accepted {
state: SupervisorState,
protocol_version: u32,
},
Refused { reason: String },
Error { reason: String },
}
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct StatusReply {
pub state: SupervisorState,
pub engine: EngineHealth,
pub latest_action: Option<ActionRecord>,
pub protocol_version: u32,
}
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum SupervisorState {
On,
Off,
}
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(tag = "kind", rename_all = "snake_case")]
pub enum EngineHealth {
Unknown,
Reachable { at: DateTime<Utc> },
Unreachable { at: DateTime<Utc>, reason: String },
}
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct ActionRecord {
pub kind: ActionKind,
pub at: DateTime<Utc>,
pub note: String,
}
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum ActionKind {
Started,
Stopped,
Killed,
Probed,
Refused,
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn request_round_trips_through_json() {
for req in [
Request::Status,
Request::Start,
Request::Stop,
Request::Kill,
] {
let line = serde_json::to_string(&req).unwrap();
assert!(!line.contains('\n'), "line framing broken: {line}");
let back: Request = serde_json::from_str(&line).unwrap();
assert_eq!(req, back);
}
}
#[test]
fn status_reply_answers_three_questions() {
let reply = StatusReply {
state: SupervisorState::On,
engine: EngineHealth::Unknown,
latest_action: None,
protocol_version: PROTOCOL_VERSION,
};
let line = serde_json::to_string(&reply).unwrap();
assert!(line.contains("\"state\""));
assert!(line.contains("\"engine\""));
assert!(line.contains("\"latest_action\""));
}
#[test]
fn unknown_kind_fails_to_deserialize() {
let bogus = "{\"kind\":\"detonate\"}";
let parsed: Result<Request, _> = serde_json::from_str(bogus);
assert!(parsed.is_err());
}
#[test]
fn protocol_version_is_one() {
assert_eq!(PROTOCOL_VERSION, 1);
}
}