orql 0.1.0

A toy SQL parser for a subset of the Oracle dialect.
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

use std::fmt::Display;

use super::Location;

pub type Result<T> = std::result::Result<T, Error>;

/// [Scanner](super::Scanner) specific errors
#[derive(Debug, PartialEq, Eq, Clone)]
pub struct Error {
    pub etype: ErrorType,
    pub loc: Location,
}

/// The various types of [scanner](super::Scanner) errors
#[derive(Debug, PartialEq, Eq, Clone)]
pub enum ErrorType {
    UnexpectedEof {
        expected: Option<&'static str>,
    },
    InvalidChar {
        char: char,
        expected: Option<&'static str>,
    },
    InvalidPlaceholder {
        details: &'static str,
    },
    UnterminatedString,
    EmptyIdent,
    UnterminatedIdent,
}

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

impl Display for Error {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self.etype {
            ErrorType::UnexpectedEof { expected } => {
                write!(f, "Unexpected end-of-file")?;
                if let Some(expected) = expected {
                    write!(f, ", expected {expected}")?;
                }
            }
            ErrorType::InvalidChar { char, expected } => {
                write!(f, "Invalid character '{}'", char.escape_debug())?;
                if let Some(expected) = expected {
                    write!(f, ", expected {expected}")?;
                }
            }
            ErrorType::InvalidPlaceholder { details } => {
                write!(f, "Invalid placeholder; {details}")?;
            }
            ErrorType::UnterminatedString => {
                write!(f, "Unterminated string literal")?;
            }
            ErrorType::EmptyIdent => {
                write!(f, "Empty identifier")?;
            }
            ErrorType::UnterminatedIdent => {
                write!(f, "Unterminated identifier")?;
            }
        }
        write!(f, " {}", self.loc)
    }
}