Struct TypedTraversalSource 

pub struct TypedTraversalSource<'g> { /* private fields */ }

Entry point for typed traversals with compile-time output tracking.

TypedTraversalSource produces TypedTraversals that know their output type at compile time, enabling type-safe terminal methods.

Creating a Source

use interstellar::prelude::*;
use interstellar::traversal::typed::TypedTraversalSource;
use std::sync::Arc;

let graph = Arc::new(Graph::new());
let snapshot = graph.snapshot();
let g = TypedTraversalSource::new(&snapshot, graph.clone());

Source Methods

Method	Returns	Terminal Output
v()	TypedTraversal<Vertex>	GraphVertex
e()	TypedTraversal<Edge>	GraphEdge
inject()	TypedTraversal<Scalar>	Value

Implementations

impl<'g> TypedTraversalSource<'g>

pub fn new<S: SnapshotLike + ?Sized>(snapshot: &'g S, graph: Arc<Graph>) -> Self

Create a new typed traversal source.

Arguments

• snapshot - A graph snapshot providing storage and interner
• graph - An Arc<Graph> for creating rich element types

Example

use interstellar::prelude::*;
use interstellar::traversal::typed::TypedTraversalSource;
use std::sync::Arc;

let graph = Arc::new(Graph::new());
let snapshot = graph.snapshot();
let g = TypedTraversalSource::new(&snapshot, graph.clone());

pub fn v(&self) -> TypedTraversal<'g, Vertex>

Start traversal from all vertices.

Returns a TypedTraversal<Vertex> where terminal methods return GraphVertex objects.

Example

use interstellar::prelude::*;
use interstellar::traversal::typed::TypedTraversalSource;
use std::sync::Arc;
use std::collections::HashMap;

let graph = Arc::new(Graph::new());
let _ = graph.add_vertex("person", HashMap::new());

let snapshot = graph.snapshot();
let g = TypedTraversalSource::new(&snapshot, graph.clone());

// next() returns Option<GraphVertex>
let v = g.v().next();
assert!(v.is_some());

pub fn e(&self) -> TypedTraversal<'g, Edge>

Start traversal from all edges.

Returns a TypedTraversal<Edge> where terminal methods return GraphEdge objects.

Example

use interstellar::prelude::*;
use interstellar::traversal::typed::TypedTraversalSource;
use std::sync::Arc;
use std::collections::HashMap;

let graph = Arc::new(Graph::new());
let a = graph.add_vertex("person", HashMap::new());
let b = graph.add_vertex("person", HashMap::new());
graph.add_edge(a, b, "knows", HashMap::new()).unwrap();

let snapshot = graph.snapshot();
let g = TypedTraversalSource::new(&snapshot, graph.clone());

// next() returns Option<GraphEdge>
let e = g.e().next();
assert!(e.is_some());

pub fn inject<T, I>(&self, values: I) -> TypedTraversal<'g, Scalar>

where I: IntoIterator<Item = T>, T: Into<Value>,

Inject arbitrary values into the traversal.

Returns a TypedTraversal<Scalar> where terminal methods return raw Value objects.

Example

use interstellar::prelude::*;
use interstellar::traversal::typed::TypedTraversalSource;
use std::sync::Arc;

let graph = Arc::new(Graph::new());
let snapshot = graph.snapshot();
let g = TypedTraversalSource::new(&snapshot, graph.clone());

let values = g.inject([1i64, 2, 3]).to_list();
assert_eq!(values.len(), 3);

pub fn graph(&self) -> &Arc<Graph>

Get the graph reference.