Struct Builder 

pub struct Builder { /* private fields */ }

sqlx::QueryBuilder’s job, over Value rather than one driver.

The paged listings build two of these per query — the page and its COUNT(*) — sharing one push_predicates, so a filter applied to only one cannot report a total the rows disagree with. See crate::query.

Implementations

impl Builder

pub fn new(dialect: Dialect, sql: impl Into<String>) -> Self

Starts a builder from a leading fragment.

The dialect comes in here rather than at build, because a predicate may need it — see Dialect::json_array_source.

pub fn dialect(&self) -> Dialect

Which dialect the fragments pushed onto this must be written for.

pub fn push(&mut self, sql: impl AsRef<str>) -> &mut Self

Appends SQL verbatim. Never reached by a value from outside.

pub fn push_bind(&mut self, value: impl Bind) -> &mut Self

Appends a ? marker and the value behind it, so a filter is compared and never executed.

pub fn separated<'b>(&'b mut self, sep: &'static str) -> Separated<'b>

A run of values joined by sep, for an IN (…) list.

QueryBuilder::separated’s job. Each value is still a ?, so a list of ids is parameters rather than interpolated SQL — the rule OrderQuery::push_predicates follows too.

pub fn sql(&self) -> &str

The statement built so far, in SQLite’s spelling. For tests.

pub fn build(self) -> Query

Hands the built statement over to be run.

The assertion is the builder’s own: every fragment reaching push is a literal from this crate, and every value went through push_bind as a ?.