Struct GraphqlApiBuilder 

pub struct GraphqlApiBuilder { /* private fields */ }

Builder for GraphqlApi. Use GraphqlApi::builder to start.

Implementations

impl GraphqlApiBuilder

pub fn max_parallel(self, n: usize) -> Self

Concurrent requests to this API at most (default 4).

pub fn rate_limit(self, per_second: f64) -> Self

Requests per second to this API at most.

pub fn request_timeout(self, timeout: Duration) -> Self

Give up on one request after timeout (default 30 s). Ignored when a client is supplied with http_client.

pub fn no_request_timeout(self) -> Self

Never time a request out. Ignored when a client is supplied.

pub fn observer( self, key: impl Into<Arc<str>>, observer: Arc<dyn TransportObserver>, ) -> Self

Report every attempt, retry and breaker transition under key (the datasource name).

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

Literal arguments always passed to the root field, e.g. json!({ "input": {} }) for a mandatory non-null input object.

pub fn response_path(self, path: impl AsRef<str>) -> Self

Dotted path walked into the root field’s value before rows are read — "edges.node" unwraps a Relay-style connection.

pub fn supports(self, supports: Supports) -> Self

Override what the server accepts; see Supports.

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

Override the Hasura aggregate field used by count: aggregate (default <root_field>_aggregate).

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

Set the Authorization header value (e.g. "Bearer <token>").

pub fn auth_refresher(self, refresher: AuthRefresher) -> Self

Get the bearer token from refresher instead of a fixed header: it is asked on the first request, and again when the API answers 401. A request waits for it, so a refresher may run an interactive sign-in. Replaces auth.

pub fn bearer_source(self, source: BearerSource) -> Self

Ask source for the bearer token on every request, retries included; see BearerSource. Replaces auth and auth_refresher.

pub fn http_client(self, client: Client) -> Self

A pre-configured reqwest::Client (timeouts, proxies, TLS).

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

Pick the filter dialect used to render conditions on tables. Defaults to FilterDialect::Generic — flat-arg schemas like SpaceX.

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

Override the filter argument name. Defaults match the dialect: "where" for Hasura, "find" for Generic.

pub fn build(self) -> GraphqlApi

Finish the configuration. Builds no HTTP client yet: unless one was given with http_client, the default client is created on the first request.

Trait Implementations

impl Clone for GraphqlApiBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphqlApiBuilder

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

Formats the value using the given formatter.