tank-core 0.47.0

Core of Tank: the Rust data layer. This is intended to be used by drivers to implement a backend.
Documentation
use crate::{
    DynQuery, TableRef,
    writer::{Context, SqlWriter},
};

/// Queryable data source (table or join tree).
///
/// Implementors know how to render themselves inside a FROM clause.
pub trait Dataset {
    /// Should columns be qualified (`schema.table.col`)?
    fn qualified_columns(&self) -> bool;
    /// Generates the SQL representation of this dataset for use in a query.
    fn write_table_name(&self, writer: &dyn SqlWriter, context: &mut Context, out: &mut DynQuery);
    /// Returns the primary table reference for this dataset.
    fn table_ref(&self) -> TableRef;
}

impl Dataset for &dyn Dataset {
    fn qualified_columns(&self) -> bool {
        (*self).qualified_columns()
    }
    fn write_table_name(&self, writer: &dyn SqlWriter, context: &mut Context, out: &mut DynQuery) {
        (*self).write_table_name(writer, context, out)
    }
    fn table_ref(&self) -> TableRef {
        (*self).table_ref()
    }
}

impl<T> Dataset for T
where
    for<'a> &'a T: Into<TableRef>,
{
    fn qualified_columns(&self) -> bool {
        false
    }

    fn write_table_name(&self, writer: &dyn SqlWriter, context: &mut Context, out: &mut DynQuery) {
        writer.write_table_ref(context, out, &self.into())
    }

    fn table_ref(&self) -> TableRef {
        self.into()
    }
}