Enum GraphqlCondition 

pub enum GraphqlCondition {
    Field(FieldCondition),
    DeferredField {
        field: String,
        op: GraphqlOp,
        value_fn: DeferredFn<AnyGraphqlType>,
    },
    And(Vec<GraphqlCondition>),
    Or(Vec<GraphqlCondition>),
    Not(Box<GraphqlCondition>),
    Deferred(DeferredFn<AnyGraphqlType>),
}

Structured filter for GraphQL requests. Built by the operator trait (GraphqlOperation in operation.rs) and rendered at fetch time.

Variants

Field(FieldCondition)

DeferredField

Like Self::Field but the value is resolved at fetch time. Used by relationship traversal — with_many/with_one builds one of these when the parent’s foreign-key value isn’t known until the parent is fetched. The deferred resolves to a scalar (the FK value); render-time wraps it in the dialect’s _eq- equivalent and merges it into the filter.

Fields

field: String

op: GraphqlOp

value_fn: DeferredFn<AnyGraphqlType>

And(Vec<GraphqlCondition>)

Or(Vec<GraphqlCondition>)

Not(Box<GraphqlCondition>)

Deferred(DeferredFn<AnyGraphqlType>)

Resolved at fetch time — produces a complete filter sub-object that already matches the surrounding dialect. Use Self::DeferredField instead unless you genuinely need to compute a non-field op value shape dynamically.

Implementations

impl GraphqlCondition

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

Build a simple field = value condition. Convenience for callers that have a value already converted to JSON.

pub fn render<'a>( &'a self, dialect: FilterDialect, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'a>>

Render this condition as a JSON object suitable for use as a GraphQL argument (typically the where: arg in Hasura, or the find: arg in flat-argument schemas).

Deferred branches are resolved here. Resolution may make out-of-band fetches (e.g. for relationship traversal), so the method is async.

Trait Implementations

impl Clone for GraphqlCondition

fn clone(&self) -> GraphqlCondition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphqlCondition

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

Formats the value using the given formatter.

impl Expressive<AnyGraphqlType> for GraphqlCondition

GraphqlCondition is Expressive so it satisfies the blanket bound on the operation trait — cond.eq(false) shape works the same way as Mongo’s chaining.

fn expr(&self) -> Expression<AnyGraphqlType>

Convert this construct into an Expression<T>.

fn preview(&self) -> String

where T: Debug + Display,

Preview the expression as a formatted string.

impl From<FieldCondition> for GraphqlCondition

fn from(fc: FieldCondition) -> Self

Converts to this type from the input type.

impl Selectable<AnyGraphqlType, GraphqlCondition> for GraphqlSelect

fn add_source( &mut self, source: impl Into<SourceRef<AnyGraphqlType>>, _alias: Option<String>, )

Adds a data source to the FROM clause (table name, subquery, etc.). This is additive — calling it multiple times adds comma-separated sources.

fn add_field(&mut self, field: impl Into<String>)

Adds a column name to the SELECT clause.

fn add_expression(&mut self, _expression: impl Expressive<AnyGraphqlType>)

Adds a complex expression to the SELECT clause.

fn add_where_condition(&mut self, condition: impl Into<GraphqlCondition>)

Adds a condition to the WHERE clause.

fn set_distinct(&mut self, distinct: bool)

Sets whether the query should return distinct results.

fn add_order_by(&mut self, order: impl Into<GraphqlCondition>, direction: Order)

Adds an ORDER BY clause with direction and optional null handling.

fn add_group_by(&mut self, expression: impl Expressive<AnyGraphqlType>)

Adds a GROUP BY clause.

fn set_limit(&mut self, limit: Option<i64>, skip: Option<i64>)

Sets LIMIT and OFFSET for result pagination.

fn clear_fields(&mut self)

Removes all fields from the SELECT clause.

fn clear_where_conditions(&mut self)

Removes all WHERE conditions.

fn clear_order_by(&mut self)

Removes all ORDER BY clauses.

fn clear_group_by(&mut self)

Removes all GROUP BY clauses.

fn has_fields(&self) -> bool

Returns true if any fields have been added to SELECT clause.

fn has_where_conditions(&self) -> bool

Returns true if any WHERE conditions have been added.

fn has_order_by(&self) -> bool

Returns true if any ORDER BY clauses have been added.

fn has_group_by(&self) -> bool

Returns true if any GROUP BY clauses have been added.

fn is_distinct(&self) -> bool

Returns true if DISTINCT mode is enabled.

fn get_limit(&self) -> Option<i64>

Returns the current LIMIT value, if set.

fn get_skip(&self) -> Option<i64>

Returns the current OFFSET/SKIP value, if set.

fn as_field(&self, _field: impl Into<String>) -> Expression<AnyGraphqlType>

Creates a single-field subquery expression from this query configuration.

fn as_count(&self) -> Expression<AnyGraphqlType>

Creates a COUNT(*) expression from this query configuration.

fn as_sum( &self, column: impl Expressive<AnyGraphqlType>, ) -> Expression<AnyGraphqlType>

Creates a SUM(column) expression from this query configuration.

fn as_max( &self, column: impl Expressive<AnyGraphqlType>, ) -> Expression<AnyGraphqlType>

Creates a MAX(column) expression from this query configuration.

fn as_min( &self, column: impl Expressive<AnyGraphqlType>, ) -> Expression<AnyGraphqlType>

Creates a MIN(column) expression from this query configuration.

fn with_source(self, source: impl Into<SourceRef<T>>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_source without alias.

fn with_source_as( self, source: impl Into<SourceRef<T>>, alias: impl Into<String>, ) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_source with alias.

fn with_condition(self, condition: impl Into<C>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_where_condition.

fn with_order(self, order: impl Into<C>, direction: Order) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_order_by.

fn with_field(self, field: impl Into<String>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_field.

fn with_expression(self, expression: impl Expressive<T>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_expression.

fn with_group_by(self, expression: impl Expressive<T>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_group_by.

fn with_distinct(self, distinct: bool) -> Self

where Self: Sized,

Builder pattern method identical to Self::set_distinct.

fn with_limit(self, limit: Option<i64>, skip: Option<i64>) -> Self

where Self: Sized,

Builder pattern method identical to Self::set_limit.

impl SelectableDataSource<AnyGraphqlType, GraphqlCondition> for GraphqlApi

type Select = GraphqlSelect

fn select(&self) -> Self::Select

fn add_select_column( &self, select: &mut Self::Select, _expression: Expression<AnyGraphqlType>, alias: Option<&str>, )

Add a column expression to a select query with optional alias. Backends must override this if they support aliases.

async fn execute_select( &self, select: &Self::Select, ) -> Result<Vec<AnyGraphqlType>>