A simple "bring your own queries and types" GraphQL client.

Design Principles

• I want to use my own Rust structures and not have them generated by macros
• I want to use my own queries and not have them generated by macros
• I want to manage queries as strings in my Rust code
• I don't know what I'm doing

Why not use it

• For now it's experimental, the API may grow and change
• There's already a popular and well tested GraphQL client in Rust
• I don't know what I'm doing

How to use it

Simple query

The github stars example demonstrates querying GitHub's GraphQL API to get the number of stars of a repository.

First create a client, that you may keep and reuse:

rust let mut graphql_client = GraphqlClient::new("https://api.github.com/graphql")?; graphql_client.set_bearer_auth("your-github-api-token");

You need the struct into which to deserialize the server's answer:

```rust

[derive(Deserialize)]

pub struct Repository { stargazers: Count, } `` (Countis a utility struct provided by byo_graphql, it's juststruct Count { totalCount: usize }`)

And you need a query: rust let query = r#"{ repository(owner: "Canop", name: "bacon") { stargazers { totalCount } } }"#; note: in the example's complete code, the query is dynamically built with format!, as you'll usually do.

Now you can fetch the data:

rust let repo: Repository = graphql_client.get_first_item(query)?; let stars: usize = repo.stargazers.into();

Querying a long list

The github issues example demonstrates how to query a long list with a cursor based exchange.