lix 0.16.0

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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

use std::any::Any;
use std::sync::Arc;

use datafusion::arrow::array::{
    Array, ArrayRef, BinaryArray, BinaryViewArray, FixedSizeBinaryArray, Int64Array,
    LargeBinaryArray, LargeStringArray, StringArray, StringViewArray,
};
use datafusion::arrow::datatypes::DataType;
use datafusion::common::{DataFusionError, Result, ScalarValue, plan_err};
use datafusion::logical_expr::{
    ColumnarValue, ScalarFunctionArgs, ScalarUDFImpl, Signature, Volatility,
};

#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub(super) struct LixOctetLength {
    signature: Signature,
}

impl LixOctetLength {
    pub(super) fn new() -> Self {
        Self {
            signature: Signature::user_defined(Volatility::Immutable),
        }
    }
}

impl ScalarUDFImpl for LixOctetLength {
    fn as_any(&self) -> &dyn Any {
        self
    }

    fn name(&self) -> &'static str {
        "octet_length"
    }

    fn signature(&self) -> &Signature {
        &self.signature
    }

    fn coerce_types(&self, arg_types: &[DataType]) -> Result<Vec<DataType>> {
        if arg_types.len() != 1 {
            return plan_err!("octet_length requires exactly one argument");
        }
        if matches!(
            arg_types[0],
            DataType::Binary
                | DataType::LargeBinary
                | DataType::BinaryView
                | DataType::FixedSizeBinary(_)
                | DataType::Utf8
                | DataType::LargeUtf8
                | DataType::Utf8View
                | DataType::Null
        ) {
            Ok(arg_types.to_vec())
        } else {
            plan_err!(
                "octet_length only accepts character or binary string values, got {}",
                arg_types[0]
            )
        }
    }

    fn return_type(&self, _arg_types: &[DataType]) -> Result<DataType> {
        Ok(DataType::Int64)
    }

    fn invoke_with_args(&self, args: ScalarFunctionArgs) -> Result<ColumnarValue> {
        let [arg] = args.args.as_slice() else {
            return plan_err!("octet_length requires exactly one argument");
        };
        let scalar_input = matches!(arg, ColumnarValue::Scalar(_));
        let arrays = ColumnarValue::values_to_arrays(std::slice::from_ref(arg))?;
        let array = arrays
            .first()
            .ok_or_else(|| DataFusionError::Internal("octet_length received no argument".into()))?;
        let values = (0..array.len())
            .map(|row| byte_length(array, row))
            .collect::<Result<Vec<_>>>()?;

        if scalar_input {
            Ok(ColumnarValue::Scalar(ScalarValue::Int64(
                values.into_iter().next().flatten(),
            )))
        } else {
            Ok(ColumnarValue::Array(Arc::new(Int64Array::from(values))))
        }
    }
}

fn byte_length(array: &ArrayRef, row: usize) -> Result<Option<i64>> {
    if array.is_null(row) {
        return Ok(None);
    }

    let length = match array.data_type() {
        DataType::Binary => array
            .as_any()
            .downcast_ref::<BinaryArray>()
            .expect("Binary data type should have a BinaryArray")
            .value(row)
            .len(),
        DataType::LargeBinary => array
            .as_any()
            .downcast_ref::<LargeBinaryArray>()
            .expect("LargeBinary data type should have a LargeBinaryArray")
            .value(row)
            .len(),
        DataType::BinaryView => array
            .as_any()
            .downcast_ref::<BinaryViewArray>()
            .expect("BinaryView data type should have a BinaryViewArray")
            .value(row)
            .len(),
        DataType::FixedSizeBinary(_) => array
            .as_any()
            .downcast_ref::<FixedSizeBinaryArray>()
            .expect("FixedSizeBinary data type should have a FixedSizeBinaryArray")
            .value(row)
            .len(),
        DataType::Utf8 => array
            .as_any()
            .downcast_ref::<StringArray>()
            .expect("Utf8 data type should have a StringArray")
            .value(row)
            .len(),
        DataType::LargeUtf8 => array
            .as_any()
            .downcast_ref::<LargeStringArray>()
            .expect("LargeUtf8 data type should have a LargeStringArray")
            .value(row)
            .len(),
        DataType::Utf8View => array
            .as_any()
            .downcast_ref::<StringViewArray>()
            .expect("Utf8View data type should have a StringViewArray")
            .value(row)
            .len(),
        data_type => {
            return Err(DataFusionError::Execution(format!(
                "octet_length does not support {data_type}"
            )));
        }
    };

    i64::try_from(length)
        .map(Some)
        .map_err(|_| DataFusionError::Execution("octet_length result exceeds BIGINT".to_string()))
}