Struct GraphqlSelect 

pub struct GraphqlSelect {

    pub root_field: Option<String>,
    pub operation_name: Option<String>,
    pub fields: Vec<String>,
    pub root_args: Option<Value>,
    pub response_path: Vec<String>,
    pub sub_selections: Vec<(String, GraphqlSelect)>,
    pub conditions: Vec<GraphqlCondition>,
    pub sort: Vec<(String, Order)>,
    pub group_by: Vec<String>,
    pub limit: Option<i64>,
    pub skip: Option<i64>,
    pub distinct: bool,
    pub dialect: FilterDialect,
    pub filter_arg_name: Option<String>,
}

GraphQL query builder — produces a query document + variables map.

Construct via GraphqlSelect::new() and the chainable builders, or via Selectable::with_* methods. Designed to be generic in shape: most servers wrap their list-field with a filter arg (where:, find:, …) plus pagination args, and the renderer handles both dialects we ship with.

Fields

root_field: Option<String>

Root field on the Query type — launches, usersList, etc.

operation_name: Option<String>

Optional operation name (e.g. query GetLaunches { … }).

fields: Vec<String>

Selected fields. A dotted path (run.commit.hash) groups into a nested selection set at render time, so a schema that nests its scalars needs no relation machinery to read them.

root_args: Option<Value>

Literal arguments always passed to the root field — the mandatory input: {} on Spacelift’s searchRuns(input: SearchInput!), say. Rendered inline alongside any filter/pagination arguments.

response_path: Vec<String>

Envelope the rows sit inside, e.g. ["edges", "node"] for a Relay connection. The selection set is wrapped in these on the way out and the response is unwrapped through them on the way back, so the two can never drift apart.

sub_selections: Vec<(String, GraphqlSelect)>

Nested selection sets for relationship traversal. Built up by the Phase 6 with_many/with_one paths.

conditions: Vec<GraphqlCondition>

Conditions combined into the filter argument.

sort: Vec<(String, Order)>

Ordering specification. Hasura renders these as order_by:; other dialects ignore them (or error) until the schema map provides a per-table override.

group_by: Vec<String>

GROUP BY fields. Most GraphQL servers don’t expose grouping at the query level — we record these for round-trip and let the renderer decide whether to surface them.

limit: Option<i64>

LIMIT. Emitted as a $limit: Int variable.

skip: Option<i64>

Offset. Emitted as a $offset: Int variable.

distinct: bool

Distinct flag — meaningful only when the schema supports it (Hasura’s distinct_on:). Plumbed through but ignored by the default renderer until a per-dialect path is added.

dialect: FilterDialect

Filter dialect — drives how conditions get rendered into a GraphQL argument. Defaults to Generic so the cheapest schemas work without configuration.

filter_arg_name: Option<String>

Override for the filter argument name. Defaults to where (Hasura) or find (Generic).

Implementations

impl GraphqlSelect

pub fn with_root_field(self, name: impl Into<String>) -> Self

pub fn with_operation_name(self, name: impl Into<String>) -> Self

pub fn with_dialect(self, dialect: FilterDialect) -> Self

pub fn with_filter_arg_name(self, name: impl Into<String>) -> Self

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

Add a terminal (scalar) field to the selection set.

pub fn with_root_args(self, args: Value) -> Self

Literal arguments always passed to the root field. Expects a JSON object; anything else is ignored at render time.

pub fn with_response_path(self, path: Vec<String>) -> Self

Envelope the rows sit inside — ["edges", "node"] wraps the selection set in edges { node { … } }.

pub fn with_sub_selection( self, name: impl Into<String>, child: GraphqlSelect, ) -> Self

Add a sub-selection — used for nested relationships in Phase 6.

pub fn with_condition(self, condition: GraphqlCondition) -> Self

pub fn with_order(self, field: impl Into<String>, order: Order) -> Self

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

impl GraphqlSelect

pub async fn render(&self) -> Result<RenderedQuery>

Produce a (query, variables) pair. Async because conditions may carry Deferred branches that resolve at fetch time.

pub fn preview(&self) -> String

The document render would produce, built synchronously so it can be shown without sending anything.

Mirrors render arm for arm — same filter, same order, same selection set, same response envelope — and differs in exactly two ways, both forced by not being allowed to do any work:

1. A deferred condition renders as a **deferred(...) marker rather than being awaited. Resolving one means asking the caller for a value that only exists mid-fetch.
2. Pagination is inlined (limit: 5) instead of going through the $limit variable, so the document reads standalone. The server is told the same numbers either way.

Everything else is the query that gets sent, and pastes into a GraphQL client as-is.

impl GraphqlSelect

pub fn new() -> Self

Trait Implementations

impl Clone for GraphqlSelect

fn clone(&self) -> GraphqlSelect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphqlSelect

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

Formats the value using the given formatter.

impl Default for GraphqlSelect

fn default() -> Self

Returns the “default value” for a type.

impl Expressive<AnyGraphqlType> for GraphqlSelect

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 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.