kernel/graph/capture/
replay_outcome.rs1use super::{
11 GraphDelta, GraphDeltaResult, OnRefusal, ReplayRefused, apply_graph_delta, replay_quietly,
12};
13use crate::graph::Graph;
14use crate::graph::resource_content::ContentError;
15
16#[derive(Debug, Clone)]
18pub enum Replay {
19 Apply(GraphDelta),
21 Skip,
23 Malformed(Malformed),
25}
26
27#[derive(Debug, Clone, PartialEq, Eq)]
29pub struct Malformed {
30 pub node_id: String,
31 pub facet: String,
32 pub error: String,
33}
34
35impl Malformed {
36 pub(super) fn new(node_id: &str, facet: &str, error: serde_json::Error) -> Self {
37 Self {
38 node_id: node_id.into(),
39 facet: facet.into(),
40 error: error.to_string(),
41 }
42 }
43
44 pub(crate) fn refused_at(self, position: usize) -> ReplayRefused {
46 ReplayRefused {
47 position,
48 reason: ContentError::InvalidFacet(self.to_string()),
49 }
50 }
51}
52
53impl std::fmt::Display for Malformed {
54 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
55 write!(
56 f,
57 "facet {} of node {} is not valid JSON: {}",
58 self.facet, self.node_id, self.error
59 )
60 }
61}
62
63#[derive(Debug, Clone, PartialEq, Eq)]
66pub enum Unwritable {
67 Skipped,
68 Malformed(Malformed),
69}
70
71impl std::fmt::Display for Unwritable {
72 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
73 match self {
74 Self::Skipped => f.write_str("obsolete record with no live form"),
75 Self::Malformed(malformed) => malformed.fmt(f),
76 }
77 }
78}
79
80impl std::error::Error for Unwritable {}
81
82impl Replay {
83 pub fn into_write(self) -> Result<GraphDelta, Unwritable> {
85 match self {
86 Self::Apply(delta) => Ok(delta),
87 Self::Skip => Err(Unwritable::Skipped),
88 Self::Malformed(malformed) => Err(Unwritable::Malformed(malformed)),
89 }
90 }
91}
92
93pub(crate) fn replay_outcomes_onto<I>(
98 graph: &mut Graph,
99 outcomes: I,
100 on_refusal: OnRefusal,
101) -> Result<(), ReplayRefused>
102where
103 I: IntoIterator<Item = Replay>,
104{
105 replay_quietly(graph, |graph| {
106 for (position, outcome) in outcomes.into_iter().enumerate() {
107 let delta = match outcome {
108 Replay::Apply(delta) => delta,
109 Replay::Skip => continue,
110 Replay::Malformed(bad) if on_refusal == OnRefusal::Stop => {
111 return Err(bad.refused_at(position));
112 },
113 Replay::Malformed(_) => continue,
114 };
115 if let GraphDeltaResult::Refused(reason) = apply_graph_delta(graph, delta)
116 && on_refusal == OnRefusal::Stop
117 {
118 return Err(ReplayRefused { position, reason });
119 }
120 }
121 Ok(())
122 })
123}