lix 0.12.3

Embeddable version control for apps and AI agents.
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

use super::expr::{BoundColumnRef, BoundExpr, BoundParamRef};
use super::read::BoundRead;
use crate::sql2::plan::branch_scope::BranchScope;
use crate::sql2::plan::predicate::BoundPredicate;
use std::collections::BTreeMap;

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct BoundWrite {
    pub(crate) target: BoundWriteTarget,
    pub(crate) op: BoundWriteOp,
    pub(crate) input: BoundWriteInput,
    pub(crate) predicate: BoundPredicate,
    pub(crate) assignments: Vec<BoundAssignment>,
    pub(crate) conflict: Option<BoundInsertConflict>,
    /// The row projection requested by a DML `RETURNING` clause.
    ///
    /// It remains part of the bound write so execution can project the exact
    /// affected image: the pre-image for DELETE and the final post-image for
    /// INSERT, UPDATE, and UPSERT.
    pub(crate) returning: Option<BoundReturning>,
    pub(crate) params: BoundParamMap,
    pub(crate) branch_scope: BranchScope,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct BoundReturning {
    pub(crate) items: Vec<BoundReturningItem>,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct BoundReturningItem {
    pub(crate) expr: BoundExpr,
    pub(crate) output_name: String,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum BoundWriteTarget {
    Row(RowWriteSurface),
    File(FileWriteSurface),
    Directory(DirectoryWriteSurface),
    Branch,
    DiffCommand(crate::sql2::DiffCommand),
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum RowWriteSurface {
    Base { schema_key: String },
    ByBranch { schema_key: String },
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum FileWriteSurface {
    Base,
    ByBranch,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum DirectoryWriteSurface {
    Base,
    ByBranch,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum BoundWriteOp {
    Insert,
    Update,
    Delete,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum BoundWriteInput {
    Values(BoundInsertValues),
    Query {
        query: Box<BoundRead>,
        columns: Vec<BoundColumnRef>,
    },
    None,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct BoundInsertValues {
    pub(crate) columns: Vec<BoundColumnRef>,
    pub(crate) rows: Vec<Vec<BoundExpr>>,
}

impl BoundInsertValues {
    pub(crate) fn column_index(&self, column_name: &str) -> Option<usize> {
        self.columns
            .iter()
            .position(|column| column.name == column_name)
    }
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct BoundAssignment {
    pub(crate) column: BoundColumnRef,
    pub(crate) value: BoundExpr,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct BoundInsertConflict {
    pub(crate) target_columns: Vec<BoundColumnRef>,
    pub(crate) action: BoundConflictAction,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum BoundConflictAction {
    /// `DO UPDATE SET ...` — apply the assignments to the conflicting row.
    DoUpdate { assignments: Vec<BoundAssignment> },
    /// `DO NOTHING` — keep the existing conflicting row unchanged.
    DoNothing,
}

impl BoundConflictAction {
    /// The DO UPDATE assignments, or an empty slice for DO NOTHING.
    pub(crate) fn assignments(&self) -> &[BoundAssignment] {
        match self {
            Self::DoUpdate { assignments } => assignments,
            Self::DoNothing => &[],
        }
    }
}

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub(crate) struct BoundParamMap {
    pub(crate) params: BTreeMap<usize, BoundParamRef>,
}