tank-core 0.49.0

Core of Tank: the Rust data layer. This is intended to be used by drivers to implement a backend.
Documentation
mod create_table;
mod delete;
mod drop_table;
mod dyn_writer;
mod insert_into;
mod select;
mod update;
mod view;

use crate::{
    AnyQuery, ColumnDef, ColumnRef, Context, Dataset, Driver, Expression, ExpressionVisitor,
    OpPrecedence, Query, SqlWriter, TableRef,
};
pub use create_table::*;
pub use delete::*;
pub use drop_table::*;
pub(crate) use dyn_writer::*;
pub use insert_into::*;
pub use select::*;
use std::{borrow::Cow, iter};
pub use update::*;

/// Entry point of the query builders, as in `Sql().select(columns).from(table)`.
#[derive(Default, Debug)]
pub struct Sql();

impl Sql {
    pub fn select<Select: ExpressionCollection>(
        self,
        select: Select,
    ) -> SelectQueryBuilder<Select, NA, NA, NA, NA, NA, NA> {
        SelectQueryBuilder {
            select,
            from: Default::default(),
            where_expr: Default::default(),
            group_by: Default::default(),
            having: Default::default(),
            order_by: Default::default(),
            limit: Default::default(),
            offset: Default::default(),
            distinct: Default::default(),
            _l: Default::default(),
            insert: NA,
        }
    }
    pub fn insert_into(self, table: impl Into<TableRef>) -> InsertIntoQueryBuilder<NA, NA> {
        InsertIntoQueryBuilder {
            table: table.into(),
            columns: Cow::Borrowed(&[]),
            values: NA,
            update: false,
            _update: Default::default(),
        }
    }
    pub fn update<From: Dataset>(self, from: From) -> UpdateQueryBuilder<From, (), NA> {
        UpdateQueryBuilder {
            from,
            set: (),
            where_expr: Default::default(),
        }
    }
    pub fn delete_from<From: Dataset>(self, from: From) -> DeleteQueryBuilder<From, NA> {
        DeleteQueryBuilder {
            from,
            where_expr: Default::default(),
        }
    }
    pub fn create_table(self, table: impl Into<TableRef>) -> CreateTableQueryBuilder<NA> {
        CreateTableQueryBuilder {
            table: table.into(),
            if_not_exists: Default::default(),
            _e: Default::default(),
        }
    }
    pub fn drop_table(self, table: impl Into<TableRef>) -> DropTableQueryBuilder<NA> {
        DropTableQueryBuilder {
            table: table.into(),
            if_exists: Default::default(),
            _e: Default::default(),
        }
    }
}

/// A builder of any statement kind, erased by calling `.boxed()` before the driver is known.
///
/// Store it, then run it on any executor with `execute(&query)`: the executor's driver renders it.
pub struct BoxQueryBuilder(Box<dyn Fn(&AnyWriter, &mut AnyQuery)>);

impl BoxQueryBuilder {
    pub(crate) fn new(write: impl Fn(&AnyWriter, &mut AnyQuery) + 'static) -> Self {
        Self(Box::new(write))
    }

    /// Builds the query for `driver`.
    pub fn build<D: Driver + 'static>(&self, driver: &D) -> Query<D> {
        let mut query = AnyQuery::default();
        self.build_into(driver, &mut query);
        query.into()
    }

    /// Writes the query for `driver` into an existing buffer.
    pub fn build_into<D: Driver + 'static>(&self, driver: &D, out: &mut AnyQuery) {
        (self.0)(&AnyWriter::new(Box::new(driver.sql_writer())), out);
    }
}

#[derive(Default, Debug)]
pub struct NA;

impl Dataset for NA {
    fn qualified_columns(&self) -> bool {
        false
    }
    fn write_table_name(
        &self,
        _writer: &dyn SqlWriter,
        _context: &mut Context,
        _out: &mut AnyQuery,
    ) {
    }
    fn table_ref(&self) -> TableRef {
        TableRef::default()
    }
}

impl OpPrecedence for NA {
    fn precedence(&self, _writer: &dyn SqlWriter) -> i32 {
        0
    }
}

impl Expression for NA {
    fn write_query(&self, _writer: &dyn SqlWriter, _context: &mut Context, _out: &mut AnyQuery) {}
    fn accept_visitor(
        &self,
        _matcher: &mut dyn ExpressionVisitor,
        _writer: &dyn SqlWriter,
        _context: &mut Context,
        _out: &mut AnyQuery,
    ) -> bool {
        false
    }
}

pub trait ExpressionCollection {
    fn expr_iter(&self) -> impl Iterator<Item = impl Expression> + Clone;
}

impl<I> ExpressionCollection for I
where
    Self: Clone,
    I: IntoIterator,
    <I as IntoIterator>::Item: Expression,
    <I as IntoIterator>::IntoIter: Clone,
{
    #[allow(refining_impl_trait)]
    fn expr_iter(&self) -> impl Iterator<Item = <I as IntoIterator>::Item> + Clone {
        self.clone().into_iter()
    }
}

impl ExpressionCollection for NA {
    fn expr_iter(&self) -> impl Iterator<Item = impl Expression> + Clone {
        iter::empty::<&dyn Expression>()
    }
}

impl ExpressionCollection for ColumnRef {
    fn expr_iter(&self) -> impl Iterator<Item = impl Expression> + Clone {
        iter::once(self)
    }
}

impl ExpressionCollection for ColumnDef {
    fn expr_iter(&self) -> impl Iterator<Item = impl Expression> + Clone {
        iter::once(self)
    }
}