prepona 0.1.0

A graph crate with simplicity in mind
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

/// Types of errors that may happen when using a graph storage.
pub enum ErrorKind {
    VertexNotFound,
    EdgeNotFound,
    InvalidEdgeId,
}

/// Error type returned by storages in `storage` module.
pub struct Error {
    kind: ErrorKind,
    msg: String,
}

impl Error {
    /// # Arguments
    /// * `kind`: Specifies what kind of error is being created.
    /// * `msg`: Cause of the error.
    ///
    /// # Returns
    /// Constructed `Error`.
    pub fn new(kind: ErrorKind, msg: String) -> Self {
        Error { kind, msg }
    }

    /// Creates a [`VertexNotFound`](crate::storage::ErrorKind::VertexNotFound) kind of error.
    ///
    /// # Arguments
    /// `vertex_id`: Id of the vertex that has not been found.
    ///
    /// # Returns
    /// `Error` with `VertexNotFound` kind and predefined msg.
    pub fn new_vnf(vertex_id: usize) -> Self {
        Error {
            kind: ErrorKind::VertexNotFound,
            msg: format!("Vertex with id: {} not found", vertex_id),
        }
    }

    /// Creates an [`EdgeNotFound`](crate::storage::ErrorKind::EdgeNotFound) kind of error.
    ///
    /// # Arguments
    /// `edge_id`: Id of the edge that has not been found.
    ///
    /// # Returns
    /// `Error` with `EdgeNotFound` kind and predefined msg.
    pub fn new_enf(edge_id: usize) -> Self {
        Error {
            kind: ErrorKind::EdgeNotFound,
            msg: format!("Edge with id: {} not found", edge_id),
        }
    }

    pub fn new_iei(src_id: usize, dst_id: usize, edge_id: usize) -> Self {
        Error {
            kind: ErrorKind::InvalidEdgeId,
            msg: format!(
                "Edge with id: {} exists but it's not from vertex: {} to vertex: {}",
                edge_id, src_id, dst_id
            ),
        }
    }

    /// # Returns
    /// Cause of the error.
    pub fn msg(&self) -> &String {
        &self.msg
    }

    /// # Returns
    /// Kind of the error.
    pub fn kind(&self) -> &ErrorKind {
        &self.kind
    }
}

impl std::fmt::Debug for Error {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(self.msg())
    }
}

impl std::fmt::Display for Error {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(self.msg())
    }
}

impl std::error::Error for Error {}