Struct RenderCtx 

pub struct RenderCtx { /* private fields */ }

Rendering context: accumulates SQL string and parameters.

Provides a semantic, chainable API for building SQL output.

Implementations

impl RenderCtx

pub fn new(param_style: ParamStyle) -> Self

pub fn with_parameterize(self, parameterize: bool) -> Self

pub fn parameterize(&self) -> bool

Whether values should be rendered as parameter placeholders.

pub fn finish(self) -> (String, Vec<Value>)

Consume the context and return the SQL string and parameters.

pub fn sql(&self) -> &str

Get the current SQL string (for inspection).

pub fn params(&self) -> &[Value]

Get the current parameters (for inspection).

pub fn keyword(&mut self, kw: &str) -> &mut Self

Write a SQL keyword. Adds a leading space if the buffer is non-empty and doesn’t end with ( or whitespace.

pub fn ident(&mut self, name: &str) -> &mut Self

Write a quoted identifier: "name".

pub fn param(&mut self, val: Value) -> &mut Self

Write a parameterized value. Appends the placeholder ($1, ?, etc.) and stores the value.

pub fn string_literal(&mut self, s: &str) -> &mut Self

Write a string literal with proper escaping: 'value'.

pub fn operator(&mut self, op: &str) -> &mut Self

Write an operator: ::, =, >, ||, etc.

pub fn paren_open(&mut self) -> &mut Self

Write opening parenthesis (, with space if needed.

pub fn paren_close(&mut self) -> &mut Self

Write closing parenthesis ).

pub fn comma(&mut self) -> &mut Self

Write a comma separator , .

pub fn space(&mut self) -> &mut Self

Write an explicit space.

pub fn write(&mut self, s: &str) -> &mut Self

Write arbitrary text (escape hatch, use sparingly).

pub fn raw_with_params(&mut self, sql: &str, params: &[Value]) -> &mut Self

Write raw SQL with %s placeholders, replacing them with dialect-appropriate parameter markers and storing the values.

Escaping rules (Django-style):

• %s → dialect placeholder ($1, ?, %s) + stores value
• %% → literal %
• %%s → literal %s (because %% becomes %, then s is just text)