Struct SqlBuilder 

pub struct SqlBuilder<'config> { /* private fields */ }

AST builder for SQL.

This builder is responsible for converting the generic syntax tree (green/red trees) into a strongly-typed SQL Abstract Syntax Tree (AST). It implements the Builder trait, allowing it to be used within the Oak incremental parsing framework.

Usage

use oak_core::{Builder, source::SourceText};
use oak_sql::{SqlBuilder, SqlLanguage};

let config = SqlLanguage::default();
let builder = SqlBuilder::new(&config);
// ... use builder to build AST from source

Implementations

impl<'config> SqlBuilder<'config>

pub fn new(config: &'config SqlLanguage) -> Self

Creates a new SqlBuilder with the specified language configuration.

Trait Implementations

impl<'config> Builder<SqlLanguage> for SqlBuilder<'config>

fn build<'a, S: Source + ?Sized>( &self, source: &S, edits: &[TextEdit], cache: &'a mut impl BuilderCache<SqlLanguage>, ) -> BuildOutput<SqlLanguage>

Builds the SQL AST from the source text and edits.

This is the main entry point for the builder. It performs the following steps:

1. Initializes a SqlParser with the current configuration.
2. Executes the parser to produce a RedTree (Concrete Syntax Tree).
3. Converts the resulting green tree into a typed SqlRoot AST.
4. Handles incremental updates by passing edits to the parser.

Examples

use oak_core::{Builder, ParseSession, source::SourceText};
use oak_sql::{SqlBuilder, SqlLanguage};

let config = SqlLanguage::default();
let builder = SqlBuilder::new(&config);
let mut cache = ParseSession::default();
let source = "SELECT * FROM users";
let output = builder.build(&source, &[], &mut cache);

if let Ok(root) = output.result {
    assert_eq!(root.statements.len(), 1);
}

Errors

Returns an error if parsing fails or if the CST cannot be lowered to a valid AST.

impl<'config> Clone for SqlBuilder<'config>

fn clone(&self) -> SqlBuilder<'config>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.