Enum toql_core::error::ToqlError

pub enum ToqlError {
    NotFound,
    NotUnique,
    JoinExpected,
    QueryParserError(PestError<Rule>),
    SqlExprParserError(PestError<Rule>),
    RoleExprParserError(PestError<Rule>),
    EncodingError(Utf8Error),
    MapperMissing(String),
    TryFromSqlArgError(TryFromSqlArgError),
    TableMapperError(TableMapperError),
    ValueMissing(String),
    SqlBuilderError(SqlBuilderError),
    DeserializeError(DeserializeError),
    SqlExprResolverError(ResolverError),
    RegistryPoisenError(String),
    NoneError(String),
}

Represents all errors

Variants

NotFound

No single record found for the Toql query.

NotUnique

Many records found, when exactly one was expected.

JoinExpected

Joined entity is missing, when exactly one was expected.

QueryParserError(PestError<Rule>)

The query parser encountered a syntax error.

SqlExprParserError(PestError<Rule>)

The sql expression parser encountered a syntax error.

RoleExprParserError(PestError<Rule>)

The role expression parser encountered a syntax error.

EncodingError(Utf8Error)

The query encoding was not valid UTF-8.

MapperMissing(String)

No mapper was found for a given struct. Contains the struct name.

TryFromSqlArgError(TryFromSqlArgError)

No mapper was found for a given struct. Contains the struct name.

TableMapperError(TableMapperError)

The Mapper encountered an error

ValueMissing(String)

Unable to put database result into struct. Contains field name.

SqlBuilderError(SqlBuilderError)

SQL Builder failed to turn Toql query into SQL query.

DeserializeError(DeserializeError)

Toql failed to convert row value into struct field

SqlExprResolverError(ResolverError)

SQL Builder failed to turn Toql query into SQL query.

RegistryPoisenError(String)

Access to shared registry, typically inside cache, failed

NoneError(String)

Expected a value in Option, but found none. Includes position. TODO:: Check to replace with std::option::NoneError + Backtrace

Trait Implementations

impl Debug for ToqlError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ToqlError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ToqlError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<DeserializeError> for ToqlError

fn from(source: DeserializeError) -> Self

Converts to this type from the input type.

impl From<Error<Rule>> for ToqlError

fn from(source: PestError<Rule>) -> Self

Converts to this type from the input type.

impl From<Error<Rule>> for ToqlError

fn from(source: PestError<Rule>) -> Self

Converts to this type from the input type.

impl From<Error<Rule>> for ToqlError

fn from(source: PestError<Rule>) -> Self

Converts to this type from the input type.

impl<PE> From<PoisonError<PE>> for ToqlError

fn from(err: PoisonError<PE>) -> ToqlError

Converts to this type from the input type.

impl From<ResolverError> for ToqlError

fn from(source: ResolverError) -> Self

Converts to this type from the input type.

impl From<SqlBuilderError> for ToqlError

fn from(source: SqlBuilderError) -> Self

Converts to this type from the input type.

impl From<TableMapperError> for ToqlError

fn from(source: TableMapperError) -> Self

Converts to this type from the input type.

impl From<TryFromSqlArgError> for ToqlError

fn from(source: TryFromSqlArgError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for ToqlError

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.

impl FromRow<Row, ToqlError> for String

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<String>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for u8

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<u8>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for bool

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<bool>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for u16

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<u16>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for u32

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<u32>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for u64

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<u64>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for i8

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<i8>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for i16

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<i16>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for i32

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<i32>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for i64

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<i64>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.

impl FromRow<Row, ToqlError> for f64

fn forward<'a, I>(iter: &mut I) -> Result<usize, ToqlError> where
    I: Iterator<Item = &'a Select>, 

Returns the number of selects This is needed to advance the iterator and the row index. The Deserializer needs this information to skip left joins that have fields selected but are null. Those left joins cause select information in the select stream that must be skipped.

fn from_row<'a, I>(
    row: &Row,
    i: &mut usize,
    iter: &mut I
) -> Result<Option<f64>, ToqlError> where
    I: Iterator<Item = &'a Select> + Clone, 

Read row values into struct, starting from index. Advances iter and index Returns None for value unselected values or joined entities that have null keys. Return Error, if value is selected, but cannot be converted.