spg-engine 7.37.21

Execution engine for SPG: glues spg-sql parsing to spg-storage. Foreign keys, joins, vectors, cold tier.
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

//! v7.37.17 (17.6 siblings) — json_extract_path + _text variants.

use spg_engine::{Engine, QueryResult};

fn first(e: &mut Engine, sql: &str) -> spg_storage::Value<'static> {
    let r = e
        .execute(sql)
        .unwrap_or_else(|err| panic!("{sql}: {err:?}"));
    let QueryResult::Rows { rows, .. } = r else {
        panic!("expected Rows");
    };
    rows[0].values[0].clone()
}

fn any_text(v: &spg_storage::Value<'_>) -> String {
    match v {
        spg_storage::Value::Text(s) => s.to_string(),
        spg_storage::Value::Json(s) => s.to_string(),
        other => panic!("expected Text/Json, got {other:?}"),
    }
}

#[test]
fn extract_path_nested_object() {
    let mut e = Engine::new();
    let v = any_text(&first(
        &mut e,
        r#"SELECT json_extract_path('{"a": {"b": {"c": 42}}}', 'a', 'b', 'c')"#,
    ));
    assert_eq!(v, "42");
}

#[test]
fn extract_path_text_strips_quotes() {
    let mut e = Engine::new();
    // _text form returns unquoted string.
    let v = any_text(&first(
        &mut e,
        r#"SELECT json_extract_path_text('{"name": "alice"}', 'name')"#,
    ));
    assert_eq!(v, "alice");
    // Non-text form keeps JSON quoting.
    let v = any_text(&first(
        &mut e,
        r#"SELECT json_extract_path('{"name": "alice"}', 'name')"#,
    ));
    assert_eq!(v, r#""alice""#);
}

#[test]
fn extract_path_array_index() {
    let mut e = Engine::new();
    let v = any_text(&first(
        &mut e,
        r#"SELECT json_extract_path('{"items": [10, 20, 30]}', 'items', '1')"#,
    ));
    assert_eq!(v, "20");
}

#[test]
fn extract_path_missing_key_returns_null() {
    let mut e = Engine::new();
    assert!(matches!(
        first(&mut e, r#"SELECT json_extract_path('{"a": 1}', 'missing')"#),
        spg_storage::Value::Null
    ));
}

#[test]
fn jsonb_variants_work() {
    let mut e = Engine::new();
    let v = any_text(&first(
        &mut e,
        r#"SELECT jsonb_extract_path_text('{"x": {"y": "z"}}', 'x', 'y')"#,
    ));
    assert_eq!(v, "z");
}

#[test]
fn extract_path_null_passthrough() {
    let mut e = Engine::new();
    assert!(matches!(
        first(&mut e, "SELECT json_extract_path(NULL::text, 'a')"),
        spg_storage::Value::Null
    ));
    assert!(matches!(
        first(
            &mut e,
            r#"SELECT json_extract_path('{"a": 1}', NULL::text)"#
        ),
        spg_storage::Value::Null
    ));
}