rocksgraph 0.1.0

A Gremlin-inspired property graph query engine written in Rust, backed by RocksDB
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

//! Physical step tests for `as` and `select`.

use crate::engine::volcano::steps::traits::CoreStep;
use crate::engine::{
    context::NoopCtx,
    traverser::Traverser,
    volcano::steps::{
        as_select::{AsStep, SelectStep},
        traits::{BufferedStep, StepRef},
        vec_source::VecSourceStep,
    },
};
use smallvec::smallvec;
use smol_str::SmolStr;
use std::rc::Rc;

fn labeled(label: &str, value: crate::types::GValue) -> Rc<Traverser> {
    Rc::new(Traverser { value, parent: None, labels: Some(smallvec![SmolStr::from(label)]) })
}

#[test]
fn test_as_step_attaches_label() {
    let src = BufferedStep::new(VecSourceStep::empty());
    src.inner
        .borrow_mut()
        .core
        .inject(smallvec![Traverser::new_rc(crate::types::GValue::Scalar(crate::types::gvalue::Primitive::Int64(42)))]);
    let mut step = AsStep::new(smallvec![SmolStr::from("x")]);
    step.add_upper(src.clone() as StepRef);
    let mut ctx = NoopCtx;
    let res = step.produce(&mut ctx).unwrap().unwrap();
    assert_eq!(res[0].labels.as_ref().unwrap()[0], SmolStr::from("x"));
    assert_eq!(res[0].value, crate::types::GValue::Scalar(crate::types::gvalue::Primitive::Int64(42)));
}

#[test]
fn test_as_no_upstream() {
    let mut step = AsStep::new(smallvec![SmolStr::from("x")]);
    let mut ctx = NoopCtx;
    assert!(step.produce(&mut ctx).unwrap().is_none());
}

#[test]
fn test_as_reset() {
    let src = BufferedStep::new(VecSourceStep::empty());
    src.inner
        .borrow_mut()
        .core
        .inject(smallvec![Traverser::new_rc(crate::types::GValue::Scalar(crate::types::gvalue::Primitive::Int64(1)))]);
    let mut step = AsStep::new(smallvec![SmolStr::from("x")]);
    step.add_upper(src.clone() as StepRef);
    let mut ctx = NoopCtx;
    assert!(step.produce(&mut ctx).unwrap().is_some());
    step.reset();
    src.inner
        .borrow_mut()
        .core
        .inject(smallvec![Traverser::new_rc(crate::types::GValue::Scalar(crate::types::gvalue::Primitive::Int64(2)))]);
    assert!(step.produce(&mut ctx).unwrap().is_some());
}

#[test]
fn test_select_finds_labeled_ancestor() {
    use crate::types::gvalue::Primitive;

    // Create a chain: t1 (labeled "a") → t2 → t3 (current)
    let t1 = labeled("a", crate::types::GValue::Scalar(Primitive::Int64(10)));
    let t2 = Rc::new(Traverser {
        value: crate::types::GValue::Scalar(Primitive::Int64(20)),
        parent: Some(Rc::clone(&t1)),
        labels: None,
    });
    let t3 = Rc::new(Traverser {
        value: crate::types::GValue::Scalar(Primitive::Int64(30)),
        parent: Some(Rc::clone(&t2)),
        labels: None,
    });

    let src = BufferedStep::new(VecSourceStep::empty());
    src.inner.borrow_mut().core.inject(smallvec![Rc::clone(&t3)]);
    let mut step = SelectStep::new(smallvec![SmolStr::from("a")]);
    step.add_upper(src.clone() as StepRef);
    let mut ctx = NoopCtx;
    // Should find t1 (labeled "a") and emit it
    let res = step.produce(&mut ctx).unwrap().unwrap();
    assert_eq!(res[0].value, crate::types::GValue::Scalar(Primitive::Int64(10)));
}

#[test]
fn test_select_no_match_filters_out() {
    use crate::types::gvalue::Primitive;

    let t1 = Rc::new(Traverser {
        value: crate::types::GValue::Scalar(Primitive::Int64(10)),
        parent: None,
        labels: Some(smallvec![SmolStr::from("x")]),
    });

    let src = BufferedStep::new(VecSourceStep::empty());
    src.inner.borrow_mut().core.inject(smallvec![t1]);
    let mut step = SelectStep::new(smallvec![SmolStr::from("y")]); // looking for "y", but has "x"
    step.add_upper(src.clone() as StepRef);
    let mut ctx = NoopCtx;
    // No matching label → filtered out → upstream exhausted → None
    assert!(step.produce(&mut ctx).unwrap().is_none());
}

#[test]
fn test_select_no_upstream() {
    let mut step = SelectStep::new(smallvec![SmolStr::from("x")]);
    let mut ctx = NoopCtx;
    assert!(step.produce(&mut ctx).unwrap().is_none());
}

#[test]
fn test_select_reset() {
    use crate::types::gvalue::Primitive;

    let t = labeled("a", crate::types::GValue::Scalar(Primitive::Int64(10)));
    let src = BufferedStep::new(VecSourceStep::empty());
    src.inner.borrow_mut().core.inject(smallvec![Rc::clone(&t)]);
    let mut step = SelectStep::new(smallvec![SmolStr::from("a")]);
    step.add_upper(src.clone() as StepRef);
    let mut ctx = NoopCtx;
    assert!(step.produce(&mut ctx).unwrap().is_some());
    step.reset();
    src.inner.borrow_mut().core.inject(smallvec![Rc::clone(&t)]);
    assert!(step.produce(&mut ctx).unwrap().is_some());
}

#[test]
fn test_select_upper() {
    let mut step = SelectStep::new(smallvec![SmolStr::from("x")]);
    assert!(step.upper().is_none());
    let src = BufferedStep::new(VecSourceStep::empty());
    step.add_upper(src.clone() as StepRef);
    assert!(step.upper().is_some());
}