kitedb 0.2.2

High-performance embedded graph database
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

//! Python bindings for Traversal and Pathfinding result types

use pyo3::prelude::*;

// ============================================================================
// Traversal Result
// ============================================================================

/// A single result from a traversal
#[pyclass(name = "TraversalResult")]
#[derive(Debug, Clone)]
pub struct PyTraversalResult {
  /// The node ID that was reached
  #[pyo3(get)]
  pub node_id: i64,
  /// The depth (number of hops) from the start
  #[pyo3(get)]
  pub depth: u32,
  /// Source node of the edge used (if any)
  #[pyo3(get)]
  pub edge_src: Option<i64>,
  /// Destination node of the edge used (if any)
  #[pyo3(get)]
  pub edge_dst: Option<i64>,
  /// Edge type used (if any)
  #[pyo3(get)]
  pub edge_type: Option<u32>,
}

#[pymethods]
impl PyTraversalResult {
  fn __repr__(&self) -> String {
    format!(
      "TraversalResult(node_id={}, depth={})",
      self.node_id, self.depth
    )
  }
}

// ============================================================================
// Path Result
// ============================================================================

/// Result of a pathfinding query
#[pyclass(name = "PathResult")]
#[derive(Debug, Clone)]
pub struct PyPathResult {
  /// Nodes in order from source to target
  #[pyo3(get)]
  pub path: Vec<i64>,
  /// Edges as PathEdge objects
  #[pyo3(get)]
  pub edges: Vec<PyPathEdge>,
  /// Sum of edge weights along the path
  #[pyo3(get)]
  pub total_weight: f64,
  /// Whether a path was found
  #[pyo3(get)]
  pub found: bool,
}

#[pymethods]
impl PyPathResult {
  fn __repr__(&self) -> String {
    if self.found {
      format!(
        "PathResult(path={:?}, total_weight={:.2})",
        self.path, self.total_weight
      )
    } else {
      "PathResult(found=False)".to_string()
    }
  }

  fn __len__(&self) -> usize {
    self.path.len()
  }

  fn __bool__(&self) -> bool {
    self.found
  }
}

/// An edge in a path result
#[pyclass(name = "PathEdge")]
#[derive(Debug, Clone)]
pub struct PyPathEdge {
  #[pyo3(get)]
  pub src: i64,
  #[pyo3(get)]
  pub etype: u32,
  #[pyo3(get)]
  pub dst: i64,
}

#[pymethods]
impl PyPathEdge {
  fn __repr__(&self) -> String {
    format!("PathEdge({} --[{}]--> {})", self.src, self.etype, self.dst)
  }
}