lix 0.18.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

use std::sync::Arc;

use datafusion::arrow::datatypes::DataType;
use datafusion::common::{Result, ScalarValue, plan_err};
use datafusion::logical_expr::{
    ColumnarValue, ScalarFunctionArgs, ScalarUDFImpl, Signature, Volatility,
};

use super::execution_slots::ExecutionSlots;

#[derive(Clone)]
pub(super) struct UuidV7 {
    pub(super) slots: Arc<ExecutionSlots>,
}

impl PartialEq for UuidV7 {
    fn eq(&self, _other: &Self) -> bool {
        true
    }
}

impl Eq for UuidV7 {}

impl std::hash::Hash for UuidV7 {
    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
        self.name().hash(state);
    }
}

impl std::fmt::Debug for UuidV7 {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("UuidV7").finish()
    }
}

impl ScalarUDFImpl for UuidV7 {

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

    fn signature(&self) -> &Signature {
        static SIGNATURE: std::sync::LazyLock<Signature> =
            std::sync::LazyLock::new(|| Signature::nullary(Volatility::Volatile));
        &SIGNATURE
    }

    fn return_type(&self, _arg_types: &[DataType]) -> Result<DataType> {
        // Lix exposes UUID values to SDKs as canonical strings while Schema
        // v1 retains the PostgreSQL logical type.
        Ok(DataType::Utf8)
    }

    fn invoke_with_args(&self, args: ScalarFunctionArgs) -> Result<ColumnarValue> {
        if !args.args.is_empty() {
            return plan_err!("uuidv7 requires no arguments");
        }
        Ok(ColumnarValue::Scalar(ScalarValue::Utf8(Some(
            self.slots.functions()?.call_uuid_v7().to_string(),
        ))))
    }
}

#[cfg(test)]
mod tests {
    use super::super::test_support::single_text;

    #[tokio::test]
    async fn returns_uuid_text() {
        let value = single_text("SELECT uuidv7()")
            .await
            .expect("uuid should not be null");
        assert!(!value.is_empty());
    }
}