sqlint 0.2.2

An abstraction layer for SQL databases.
Documentation
use crate::ast::{Expression, Query, Select};
use std::{collections::BTreeSet, fmt};

use super::CommonTableExpression;
use super::IntoCommonTableExpression;

#[derive(Debug, PartialEq, Clone, Copy)]
pub(crate) enum UnionType {
    All,
    Distinct,
}

impl fmt::Display for UnionType {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            UnionType::All => write!(f, "UNION ALL"),
            UnionType::Distinct => write!(f, "UNION"),
        }
    }
}

/// A builder for a `UNION`s over multiple `SELECT` statements.
#[derive(Debug, PartialEq, Clone, Default)]
pub struct Union<'a> {
    pub(crate) selects: Vec<Select<'a>>,
    pub(crate) types: Vec<UnionType>,
    pub(crate) ctes: Vec<CommonTableExpression<'a>>,
}

impl<'a> From<Union<'a>> for Query<'a> {
    fn from(ua: Union<'a>) -> Self {
        Query::Union(Box::new(ua))
    }
}

impl<'a> From<Union<'a>> for Expression<'a> {
    fn from(uaua: Union<'a>) -> Self {
        Expression::union(uaua)
    }
}

impl<'a> Union<'a> {
    pub fn new(q: Select<'a>) -> Self {
        Self { selects: vec![q], types: Vec::new(), ctes: Vec::new() }
    }

    /// Creates a union with previous selection and the given `SELECT`
    /// statement, allowing duplicates.
    ///
    /// ```rust
    /// # use sqlint::{ast::*, visitor::{Visitor, Sqlite}};
    /// # fn main() -> Result<(), sqlint::error::Error> {
    /// let s1 = Select::default().value(1);
    /// let s2 = Select::default().value(2);
    /// let (sql, params) = Sqlite::build(Union::new(s1).all(s2))?;
    ///
    /// assert_eq!("SELECT ? UNION ALL SELECT ?", sql);
    ///
    /// assert_eq!(vec![
    ///     Value::from(1),
    ///     Value::from(2)
    /// ], params);
    /// # Ok(())
    /// # }
    /// ```
    pub fn all(mut self, q: Select<'a>) -> Self {
        self.selects.push(q);
        self.types.push(UnionType::All);
        self
    }

    /// Creates a union with previous selection and the given `SELECT`
    /// statement, selecting only distinct values.
    ///
    /// ```rust
    /// # use sqlint::{ast::*, visitor::{Visitor, Sqlite}};
    /// # fn main() -> Result<(), sqlint::error::Error> {
    /// let s1 = Select::default().value(1);
    /// let s2 = Select::default().value(2);
    /// let (sql, params) = Sqlite::build(Union::new(s1).distinct(s2))?;
    ///
    /// assert_eq!("SELECT ? UNION SELECT ?", sql);
    ///
    /// assert_eq!(vec![
    ///     Value::from(1),
    ///     Value::from(2)
    /// ], params);
    /// # Ok(())
    /// # }
    /// ```
    pub fn distinct(mut self, q: Select<'a>) -> Self {
        self.selects.push(q);
        self.types.push(UnionType::Distinct);
        self
    }

    /// A list of item names in the queries, skipping the anonymous values or
    /// columns.
    pub(crate) fn named_selection(&self) -> Vec<String> {
        self.selects
            .iter()
            .fold(BTreeSet::new(), |mut acc, select| {
                for name in select.named_selection() {
                    acc.insert(name);
                }

                acc
            })
            .into_iter()
            .collect()
    }

    /// Finds all comparisons between tuples and selects in the queries and
    /// converts them to common table expressions for making the query
    /// compatible with databases not supporting tuples.
    #[cfg(feature = "mssql")]
    pub(crate) fn convert_tuple_selects_into_ctes(
        mut self,
        top_level: bool,
        level: &mut usize,
    ) -> either::Either<Self, (Self, Vec<CommonTableExpression<'a>>)> {
        let mut queries = Vec::with_capacity(self.selects.len());
        let mut combined_ctes = Vec::new();

        for select in self.selects.drain(0..) {
            let (select, ctes) = select
                .convert_tuple_selects_to_ctes(false, level)
                .expect_right("Nested select should always be right.");

            queries.push(select);
            combined_ctes.extend(ctes);
        }

        self.selects = queries;

        if top_level {
            self.ctes = combined_ctes;
            either::Either::Left(self)
        } else {
            either::Either::Right((self, combined_ctes))
        }
    }
}

impl<'a> IntoCommonTableExpression<'a> for Union<'a> {}