basex 0.7.0

A client library for BaseX XQuery databases.
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

use std::str::FromStr;

/// The error type for failed query execution.
#[derive(Debug)]
pub struct QueryFailed {
    raw: String,
    code: String,
    line: usize,
    position: usize,
    message: String,
    file: String,
}

impl QueryFailed {
    pub(crate) fn new(raw: String) -> Self {
        let code_index = raw.find('[').unwrap();
        let code_stop = code_index + raw[code_index..].find(']').unwrap();
        let code = raw[code_index + 1..code_stop].to_owned();

        let line_separator = raw[..code_index].rfind('/').unwrap();
        let line_start = raw[..line_separator].rfind(',').unwrap();
        let line_stop = line_separator + raw[line_separator..].find(':').unwrap();
        let line = &raw[line_start + 2..line_separator];
        let line = usize::from_str(line).unwrap();

        let position = &raw[line_separator + 1..line_stop];
        let position = usize::from_str(position).unwrap();

        let message = raw[code_stop + 2..].to_owned();
        let file = raw[11..line_start].to_owned();

        Self {
            raw,
            code,
            line,
            position,
            message,
            file,
        }
    }

    /// The unparsed error string.
    pub fn raw(&self) -> &str {
        &self.raw
    }

    /// The XQuery [error code](https://docs.basex.org/wiki/XQuery_Errors).
    pub fn code(&self) -> &str {
        &self.code
    }

    /// The line in the file where the error occurred.
    pub fn line(&self) -> usize {
        self.line
    }

    /// The character position in the line where the error occurred.
    pub fn position(&self) -> usize {
        self.position
    }

    /// The error message.
    pub fn message(&self) -> &str {
        &self.message
    }

    /// The XQuery source file. Is presented as `.` (dot character) when not from file.
    pub fn file(&self) -> &str {
        &self.file
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_parsing_errors() {
        let dataset = [
            (
                "Stopped at ., 1/2264: [XPST0003] Expecting ']', found '&'. Error in parse(text = x) : attempt to use \
                 zero-length variable name",
                "XPST0003",
                "Expecting ']', found '&'. Error in parse(text = x) : attempt to use zero-length variable name",
                ".",
                1,
                2264,
            ),
            (
                "Stopped at C:/Program Files (x86)/BaseX/etc/file2, 9/6: [XPST0003] Expecting '}', found '{'.",
                "XPST0003",
                "Expecting '}', found '{'.",
                "C:/Program Files (x86)/BaseX/etc/file2",
                9,
                6,
            ),
            (
                "Stopped at ., 1/87: [bxerr:BASX0000] java.lang.StringIndexOutOfBoundsException: String index out of \
                range: -1 Error in parse(text = x) : attempt to use zero-length variable name",
                "bxerr:BASX0000",
                "java.lang.StringIndexOutOfBoundsException: String index out of range: -1 Error in parse(text = x) : \
                attempt to use zero-length variable name",
                ".",
                1,
                87,
            ),
        ];

        for (expected_raw, expected_code, expected_message, expected_file, expected_line, expected_position) in dataset
        {
            let error = QueryFailed::new(expected_raw.to_owned());

            assert_eq!(expected_raw, error.raw());
            assert_eq!(expected_code, error.code());
            assert_eq!(expected_message, error.message());
            assert_eq!(expected_file, error.file());
            assert_eq!(expected_line, error.line());
            assert_eq!(expected_position, error.position());
        }
    }
}