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
|
/*
* This file is part of Datafu
* Copyright (C) 2021 Soni L.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
//! <!-- TODO figure out module-level docs for this -->
#[cfg(doc)]
use crate::PatternTypes;
/// These are errors that may be returned by the pattern compiler when
/// compiling a pattern.
///
/// "String" here refers to a string literal in the pattern, not the input
/// string. The input string is referred to as "the pattern".
#[derive(Debug)]
pub enum PatternError<'a> {
// Syntax Errors:
/// The pattern contains an invalid string escape.
StringEscape(usize, &'a str),
/// The pattern ends in the middle of a string literal.
StringEnd(usize, &'a str),
/// The pattern contains an invalid regex escape.
RegexEscape(usize, &'a str),
/// The pattern ends in the middle of a regex literal.
RegexEnd(usize, &'a str),
/// The pattern contains characters that don't make up a token.
Token(usize, &'a str),
// Link Errors:
/// The pattern requests a parameter that wasn't provided.
UnknownParameter(usize, &'a str),
/// The pattern requests a predicate that wasn't provided.
UnknownPredicate(usize, &'a str),
/// The pattern contains an invalid regex.
Regex(usize, &'a str, ::regex::Error),
}
/// These are errors that may be returned by the matcher when matching a
/// pattern.
#[derive(Clone, Debug)]
pub enum MatchError {
/// Returned if the pattern nests too deeply.
StackOverflow,
/// Returned if the pattern rejects the input.
ValidationError,
/// Returned if the pattern attempts an unsupported operation.
///
/// In particular, if the [`PatternTypes`] doesn't support `get` or `pairs`
/// for a given value, this error will be returned. It can be treated as a
/// ValidationError, or as a bug in the pattern, at the user's discretion.
UnsupportedOperation,
/// Returned if an unspecified non-critical error occurred.
Other
}
|
