Struct QueryBuilder 

pub struct QueryBuilder { /* private fields */ }

Builder for constructing type-safe queries.

Example

use sqry_core::query::builder::QueryBuilder;

let query = QueryBuilder::kind("function")
    .and(QueryBuilder::lang("rust"))
    .and_not(QueryBuilder::name_matches("test.*"))
    .build()?;

Implementations

impl QueryBuilder

pub fn new() -> Self

Create empty builder for chaining

pub fn kind(value: impl Into<String>) -> Self

Filter by symbol kind (function, method, class, etc.)

pub fn kind_any(values: &[&str]) -> Self

Filter by multiple symbol kinds (OR)

pub fn name(value: impl Into<String>) -> Self

Filter by symbol name (exact match)

pub fn name_matches(pattern: impl Into<String>) -> Self

Filter by symbol name (regex match with default flags)

pub fn name_matches_with<F>(pattern: impl Into<String>, configure: F) -> Self

where F: FnOnce(RegexBuilder) -> RegexBuilder,

Filter by symbol name (regex match with custom flags via closure)

Example

// Case-insensitive name matching
QueryBuilder::name_matches_with("test.*", |rb| rb.case_insensitive())

pub fn lang(value: impl Into<String>) -> Self

Filter by programming language

pub fn language(value: impl Into<String>) -> Self

Filter by programming language (alias for lang)

pub fn path(value: impl Into<String>) -> Self

Filter by file path (exact or glob match)

pub fn file(value: impl Into<String>) -> Self

Filter by file path (alias for path)

pub fn path_matches(pattern: impl Into<String>) -> Self

Filter by file path (regex match with default flags)

pub fn path_matches_with<F>(pattern: impl Into<String>, configure: F) -> Self

where F: FnOnce(RegexBuilder) -> RegexBuilder,

Filter by file path (regex match with custom flags via closure)

Example

// Case-insensitive path matching
QueryBuilder::path_matches_with(".*test.*", |rb| rb.case_insensitive())

pub fn repo(value: impl Into<String>) -> Self

Filter by repository

pub fn parent(value: impl Into<String>) -> Self

Filter by parent symbol

pub fn text_matches(pattern: impl Into<String>) -> Self

Filter by text content (regex only, default flags)

pub fn text_matches_with<F>(pattern: impl Into<String>, configure: F) -> Self

where F: FnOnce(RegexBuilder) -> RegexBuilder,

Filter by text content (regex with custom flags via closure)

Example

// Multi-line text matching
QueryBuilder::text_matches_with("^pub fn.*$", |rb| rb.multiline())

pub fn callers(symbol: impl Into<String>) -> Self

Filter symbols that call the specified symbol

pub fn callees(symbol: impl Into<String>) -> Self

Filter symbols called by the specified symbol

pub fn imports(module: impl Into<String>) -> Self

Filter symbols that import the specified module

pub fn exports(value: impl Into<String>) -> Self

Filter symbols that export something

pub fn returns(type_name: impl Into<String>) -> Self

Filter symbols with the specified return type

pub fn references(symbol: impl Into<String>) -> Self

Filter symbols that reference the specified symbol

pub fn scope(value: impl Into<String>) -> Self

Filter by scope (file, module, class, function, block)

This targets the core scope field (enum type).

pub fn scope_type(value: impl Into<String>) -> Self

Filter by scope type (module, function, class, struct, method, block, etc.)

This targets the scope.type compound field for nested scope filtering.

pub fn scope_name(value: impl Into<String>) -> Self

Filter by scope name

pub fn scope_parent(value: impl Into<String>) -> Self

Filter by scope parent

pub fn scope_ancestor(value: impl Into<String>) -> Self

Filter by scope ancestor (transitive parent)

pub fn field(name: impl Into<String>, value: impl Into<Value>) -> Self

Access any field by name with a value

pub fn field_matches( name: impl Into<String>, pattern: impl Into<String>, ) -> Self

Access any field by name with regex match (default flags)

pub fn field_matches_with<F>( name: impl Into<String>, pattern: impl Into<String>, configure: F, ) -> Self

where F: FnOnce(RegexBuilder) -> RegexBuilder,

Access any field by name with regex match (custom flags via closure)

Example

// Case-insensitive field matching
QueryBuilder::field_matches_with("custom_field", "pattern.*", |rb| rb.case_insensitive())

pub fn field_gt(name: impl Into<String>, value: i64) -> Self

Numeric comparison: field > value

pub fn field_gte(name: impl Into<String>, value: i64) -> Self

Numeric comparison: field >= value

pub fn field_lt(name: impl Into<String>, value: i64) -> Self

Numeric comparison: field < value

pub fn field_lte(name: impl Into<String>, value: i64) -> Self

Numeric comparison: field <= value

impl QueryBuilder

pub fn all(conditions: Vec<QueryBuilder>) -> Self

Static constructor: AND of multiple conditions

pub fn any(conditions: Vec<QueryBuilder>) -> Self

Static constructor: OR of multiple conditions

pub fn and(self, other: QueryBuilder) -> Self

Chainable: combine with AND

pub fn or(self, other: QueryBuilder) -> Self

Chainable: combine with OR

pub fn and_not(self, other: QueryBuilder) -> Self

Chainable: combine with AND NOT

pub fn negate(builder: QueryBuilder) -> Self

Static constructor: negate expression

Named negate to avoid confusion with std::ops::Not::not. Use this to create NOT <expr> conditions.

impl QueryBuilder

pub fn build(self) -> Result<Arc<QueryAST>, BuildError>

Build the query with default field registry validation

Errors

Returns BuildError if:

• Unknown field names are used
• Operators are incompatible with field types
• Value types don’t match field types
• Enum values are invalid
• Regex patterns are syntactically invalid
• The query is empty (no conditions)

pub fn build_with_registry( self, registry: &FieldRegistry, ) -> Result<Arc<QueryAST>, BuildError>

Build with custom field registry (for plugin fields)

This allows validation against a registry that includes plugin-specific fields in addition to core fields.

Errors

Same as build().

Trait Implementations

impl Clone for QueryBuilder

fn clone(&self) -> QueryBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for QueryBuilder

fn default() -> Self

Returns the “default value” for a type.