diff --git a/sqlx-core/src/query_builder.rs b/sqlx-core/src/query_builder.rs index 72debfd6da..15ef034564 100644 --- a/sqlx-core/src/query_builder.rs +++ b/sqlx-core/src/query_builder.rs @@ -7,7 +7,9 @@ use std::marker::PhantomData; use crate::arguments::Arguments; use crate::database::{Database, HasArguments}; use crate::encode::Encode; +use crate::from_row::FromRow; use crate::query::Query; +use crate::query_as::QueryAs; use crate::types::Type; use crate::Either; @@ -392,7 +394,6 @@ where for tuple in tuples { separated.push("("); - // use a `Separated` with a separate (hah) internal state push_tuple(separated.query_builder.separated(", "), tuple); separated.push_unseparated(")"); @@ -425,6 +426,27 @@ where } } + /// Produce an executable query from this builder. + /// + /// ### Note: Query is not Checked + /// It is your responsibility to ensure that you produce a syntactically correct query here, + /// this API has no way to check it for you. + /// + /// ### Note: Reuse + /// You can reuse this builder afterwards to amortize the allocation overhead of the query + /// string, however you must call [`.reset()`][Self::reset] first, which returns `Self` + /// to the state it was in immediately after [`new()`][Self::new]. + /// + /// Calling any other method but `.reset()` after `.build()` will panic for sanity reasons. + pub fn build_query_as<'q, T: FromRow<'q, DB::Row>>( + &'q mut self, + ) -> QueryAs<'q, DB, T, >::Arguments> { + QueryAs { + inner: self.build(), + output: PhantomData, + } + } + /// Reset this `QueryBuilder` back to its initial state. /// /// The query is truncated to the initial fragment provided to [`new()`][Self::new] and @@ -435,6 +457,16 @@ where self } + + /// Get the current build SQL; **note**: may not be syntactically correct. + pub fn sql(&self) -> &str { + &self.query + } + + /// Deconstruct this `QueryBuilder`, returning the built SQL. May not be syntactically correct. + pub fn into_sql(self) -> String { + self.query + } } /// A wrapper around `QueryBuilder` for creating comma(or other token)-separated lists.