1use indexmap::IndexMap;
8use serde::{Deserialize, Serialize};
9
10use crate::event::Usage;
11use crate::pool::{PoolSnapshot, Selector};
12use crate::value::Value;
13
14pub const SNAPSHOT_FORMAT: u32 = 1;
16
17#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
19pub struct Snapshot {
20 pub format: u32,
21 pub run_id: String,
22 pub graph_fingerprint: String,
24 pub elapsed_ms: u64,
25 pub steps: u64,
26 pub usage: Usage,
27 pub handled_errors: u32,
28 pub root: FrameSnapshot,
29}
30
31#[derive(Clone, Debug, Default, PartialEq, Serialize, Deserialize)]
33pub struct FrameSnapshot {
34 pub pool: PoolSnapshot,
35 pub nodes: IndexMap<String, NodeSnapshot>,
37 pub edges: IndexMap<String, EdgeStatus>,
39 pub outputs: IndexMap<String, Value>,
41 #[serde(default, skip_serializing_if = "Vec::is_empty")]
43 pub writes: Vec<(Selector, Value)>,
44 #[serde(default, skip_serializing_if = "std::ops::Not::not")]
46 pub broke: bool,
47 #[serde(default)]
49 pub usage: Usage,
50}
51
52#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
54#[serde(rename_all = "snake_case")]
55#[non_exhaustive]
56pub enum NodeStatus {
57 Pending,
59 Paused,
61 Succeeded,
62 Failed,
63 Skipped,
64}
65
66#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
68pub struct NodeSnapshot {
69 pub status: NodeStatus,
70 pub exec_id: String,
71 pub attempt: u32,
72 #[serde(default, skip_serializing_if = "Option::is_none")]
75 pub resume_state: Option<serde_json::Value>,
76}
77
78#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
80#[serde(rename_all = "snake_case")]
81#[non_exhaustive]
82pub enum EdgeStatus {
83 Unknown,
84 Taken,
85 Skipped,
86}
87
88impl Snapshot {
89 pub fn to_json(&self) -> Result<String, serde_json::Error> {
91 serde_json::to_string(self)
92 }
93
94 pub fn from_json(text: &str) -> Result<Self, serde_json::Error> {
96 serde_json::from_str(text)
97 }
98}