kuliya 0.1.3

A library for querying Algerian education dataset.
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

//! This module contains the API for the `static` feature.

use super::_auto_generated;
use super::node::Node;

/// Retrieves a node by its path.
///
/// # Arguments
///
/// * `path` - A string slice that holds the path of the node.
///
/// # Returns
///
/// * `Option<&Node>` - An optional reference to the node if found, otherwise `None`.
pub fn get_node_by_path(path: &str) -> Option<&Node> {
    _auto_generated::data::get_node_by_path(path)
}

/// Retrieves the children of a node by its path.
/// # Arguments
///
/// * `path` - A string slice that holds the path of the node.
///
/// # Returns
///
/// * `Vec<&Node>` - A vector of references to the children nodes.
pub fn get_node_children_by_path(path: &str) -> Vec<&Node> {
    _auto_generated::data::get_node_children_by_path(path)
}

#[cfg(test)]
mod test {
    use super::get_node_by_path;
    use crate::r#static::node::{Node, NodeName, NodeTerms, NodeType};

    #[test]
    fn check_three_schemas_and_non_existent() {
        let umkb = Node {
            code: "umkb",
            name: NodeName {
                ar: "جامعة محمد خيضر بسكرة",
                en: "University of Mohamed Khider Biskra",
                fr: "Université Mohamed Khider Biskra",
            },
            r#type: NodeType::University,
        };
        let sec = Node {
            code: "sec",
            name: NodeName {
                ar: "تخصص التحكم الكهربائي",
                en: "Specialy of Electrical Control",
                fr: "Spécialité de commande électrique",
            },
            r#type: NodeType::Specialty {
                terms: NodeTerms {
                    per_year: 2,
                    slots: &[7, 8, 9, 10],
                },
            },
        };
        let fst = Node {
            code: "fst",
            name: NodeName {
                ar: "كلية العلوم والتكنلوجيا",
                en: "Faculty of Science and Technology",
                fr: "Faculté des Sciences et de la Technologie",
            },
            r#type: NodeType::Faculty,
        };

        let tests = vec![
            (
                "umkb",
                Some(&umkb),
                #[cfg(feature = "serde_derive")]
                "{\"code\":\"umkb\",\"name\":{\"ar\":\"جامعة محمد خيضر بسكرة\",\"en\":\"University of Mohamed Khider Biskra\",\"fr\":\"Université Mohamed Khider Biskra\"},\"type\":\"UNIVERSITY\"}",
            ),
            (
                "umkb/fst",
                Some(&fst),
                #[cfg(feature = "serde_derive")]
                "{\"code\":\"fst\",\"name\":{\"ar\":\"كلية العلوم والتكنلوجيا\",\"en\":\"Faculty of Science and Technology\",\"fr\":\"Faculté des Sciences et de la Technologie\"},\"type\":\"FACULTY\"}",
            ),
            (
                "umkb/fst/dee/sec",
                Some(&sec),
                #[cfg(feature = "serde_derive")]
                "{\"code\":\"sec\",\"name\":{\"ar\":\"تخصص التحكم الكهربائي\",\"en\":\"Specialy of Electrical Control\",\"fr\":\"Spécialité de commande électrique\"},\"type\":\"SPECIALTY\",\"terms\":{\"perYear\":2,\"slots\":[7,8,9,10]}}",
            ),
            (
                "does/not/exist", None,
                #[cfg(feature = "serde_derive")]
                "null"
            ),
        ];

        for test_case in tests {
            let path = test_case.0;
            let expected = test_case.1;
            let actual = get_node_by_path(path);

            assert_eq!(actual, expected);
            #[cfg(feature = "serde_derive")]
            {
                let expected_stringified = test_case.2;
                assert_eq!(
                    serde_json::to_string(&actual).unwrap(),
                    expected_stringified
                );
            }
        }
    }
}