safe-migrate 0.8.0

Check PostgreSQL migrations against a synchronized database baseline
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

use crate::_internal::analysis::graph::DependencyEdge;
use crate::_internal::ast::identifiers::ObjectId;
use crate::_internal::model::relation::RelationOverlay;
use crate::_internal::model::schema::SchemaOverlay;
use crate::_internal::model::sequence::SequenceOverlay;
use crate::_internal::model::types::TypeOverlay;
use std::collections::{HashMap, HashSet};

#[derive(Debug, Clone)]
pub struct NamespaceSnapshot {
    pub schemas: HashMap<String, SchemaOverlay>,
    pub relations: HashMap<ObjectId, RelationOverlay>,
    pub types: HashMap<ObjectId, TypeOverlay>,
    pub functions: HashMap<ObjectId, crate::_internal::model::function::FunctionOverlay>,
    pub sequences: HashMap<ObjectId, SequenceOverlay>,
    pub publications: HashMap<String, crate::_internal::model::replication::PublicationOverlay>,
    pub triggers: HashMap<ObjectId, crate::_internal::model::trigger::TriggerOverlay>,
    pub constraints:
        HashMap<(ObjectId, String), crate::_internal::model::constraint::ConstraintState>,
    pub graph: Vec<DependencyEdge>,
    pub pending_validation: HashSet<(ObjectId, String)>,
    pub baseline_relations: HashSet<ObjectId>,
    pub baseline_indexes: HashSet<ObjectId>,
    pub baseline_foreign_keys: HashSet<(ObjectId, String)>,
    pub baseline_fk_dependencies: HashSet<ObjectId>,
    pub baseline_sequences: HashSet<ObjectId>,
    pub scoped_external_relation_dependencies: HashSet<ObjectId>,
    pub scoped_external_type_dependencies: HashSet<ObjectId>,
    pub scoped_external_routine_dependencies: HashSet<ObjectId>,
    pub baseline_schemas: Option<HashSet<String>>,
    pub search_path: Vec<String>,
    pub search_path_template: Vec<String>,
    pub session_search_path_template: Vec<String>,
}

#[derive(Debug, Clone)]
pub enum StateChange {
    SchemaSnapshot {
        name: String,
        previous: Option<SchemaOverlay>,
    },
    NamespaceSnapshot(Box<NamespaceSnapshot>),
    RelationSnapshot {
        id: ObjectId,
        previous: Box<Option<RelationOverlay>>,
    },
    TypeSnapshot {
        id: ObjectId,
        previous: Option<TypeOverlay>,
    },
    SequenceSnapshot {
        id: ObjectId,
        previous: Option<SequenceOverlay>,
    },
    SearchPathSnapshot {
        previous: Vec<String>,
        previous_template: Vec<String>,
        previous_session_template: Vec<String>,
    },
    TimeoutSettingsSnapshot {
        lock_timeout: crate::_internal::analysis::settings::ScopedSetting<Option<u64>>,
        statement_timeout: crate::_internal::analysis::settings::ScopedSetting<Option<u64>>,
    },
    GenerationCounterSnapshot {
        previous: u64,
    },
    PendingValidationSnapshot {
        previous: HashSet<(ObjectId, String)>,
    },
    GraphLengthMarker {
        len: usize,
    },
    GraphSnapshot {
        previous: Vec<DependencyEdge>,
    },
    FunctionSnapshot {
        id: ObjectId,
        previous: Option<crate::_internal::model::function::FunctionOverlay>,
    },
    PublicationSnapshot {
        id: ObjectId,
        previous: Option<crate::_internal::model::replication::PublicationOverlay>,
    },
    SubscriptionSnapshot {
        id: ObjectId,
        previous: Option<crate::_internal::model::replication::SubscriptionOverlay>,
    },
    RoleSnapshot {
        id: ObjectId,
        previous: Option<crate::_internal::model::role::RoleOverlay>,
    },
    RoleMembershipGrantorsSnapshot {
        previous: Vec<crate::_internal::model::role::RoleMembershipGrantor>,
        previous_complete: bool,
    },
    TriggerSnapshot {
        id: ObjectId,
        previous: Option<crate::_internal::model::trigger::TriggerOverlay>,
    },
    ConstraintSnapshot {
        table_id: ObjectId,
        name: String,
        previous: Option<crate::_internal::model::constraint::ConstraintState>,
    },
    BaselineForeignKeysSnapshot {
        previous: HashSet<(ObjectId, String)>,
    },
    RoleContextSnapshot {
        current_role: String,
        current_role_known: bool,
        persistent_current_role: String,
        persistent_current_role_known: bool,
        session_role: String,
        session_role_known: bool,
        persistent_session_role: String,
        persistent_session_role_known: bool,
    },
    ConfidenceSnapshot {
        previous: crate::_internal::analysis::state::Confidence,
    },
    EvidenceSnapshot {
        previous: crate::_internal::analysis::evidence::EvidenceLog,
    },
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum TransactionFrameKind {
    Root,
    Savepoint(String),
}

#[derive(Debug, Clone)]
pub struct TransactionFrame {
    pub kind: TransactionFrameKind,
    pub undo_log: Vec<StateChange>,
}

impl TransactionFrame {
    pub fn root() -> Self {
        Self {
            kind: TransactionFrameKind::Root,
            undo_log: Vec::new(),
        }
    }

    pub fn savepoint(name: impl Into<String>) -> Self {
        Self {
            kind: TransactionFrameKind::Savepoint(name.into()),
            undo_log: Vec::new(),
        }
    }

    pub fn is_named_savepoint(&self, name: &str) -> bool {
        matches!(&self.kind, TransactionFrameKind::Savepoint(candidate) if candidate == name)
    }
}