foch 0.0.2

EU4 mod analysis and merge toolkit
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

use serde::{Deserialize, Serialize};

use crate::merge::kernel::{ClassId, RevisionId, RevisionNode, SourceSet};

#[derive(Clone, Copy, Debug, Eq, Ord, PartialEq, PartialOrd, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum MergePolicyKind {
	ConservativeStructural,
	OneSidedRemoval,
	DeleteModify,
	AncestorClosure,
	SubtreeSelection,
	ChildSetSelection,
	DivergentNode,
	ScalarReducer,
	Ordering,
	ManualResolution,
}

#[derive(Clone, Copy, Debug, Eq, Ord, PartialEq, PartialOrd, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum MergeDecisionReason {
	Unchanged,
	OneSidedChange,
	EquivalentChanges,
	ExplicitDomainRule,
	Precedence,
	StructuralConstraint,
	ExplicitResolution,
}

#[derive(Clone, Debug, Eq, Ord, PartialEq, PartialOrd, Serialize, Deserialize)]
#[serde(rename_all = "snake_case", tag = "kind")]
pub enum MergeDecisionResult {
	SelectSource {
		source: RevisionNode,
	},
	Delete {
		deleted_by: Vec<RevisionId>,
		base: RevisionNode,
	},
	SynthesizeScalar {
		value: String,
	},
	CombineChildren,
}

#[derive(Clone, Debug, Eq, PartialEq, Serialize, Deserialize)]
pub struct MergeDecisionEvidence {
	pub affected_class: ClassId,
	pub policy: MergePolicyKind,
	pub reason: MergeDecisionReason,
	pub contributors: SourceSet,
	pub result: MergeDecisionResult,
}

#[cfg(test)]
mod tests {
	use crate::merge::kernel::{NodeId, RevisionId, RevisionNode};

	use super::*;

	#[test]
	fn decision_evidence_serialization_is_deterministic() {
		let evidence = MergeDecisionEvidence {
			affected_class: ClassId::new(7),
			policy: MergePolicyKind::DivergentNode,
			reason: MergeDecisionReason::ExplicitDomainRule,
			contributors: SourceSet::new([
				RevisionNode::new(RevisionId::RIGHT, NodeId::new(4)),
				RevisionNode::new(RevisionId::LEFT, NodeId::new(8)),
			]),
			result: MergeDecisionResult::SelectSource {
				source: RevisionNode::new(RevisionId::RIGHT, NodeId::new(4)),
			},
		};

		assert_eq!(
			serde_json::to_string(&evidence).unwrap(),
			serde_json::to_string(&evidence.clone()).unwrap()
		);
	}
}