gql_client

Minimal GraphQL client for Rust

Simple API, supports queries and mutations
Does not require schema file for introspection
Supports WebAssembly

Basic Usage

Use client.querywithvars for queries with variables
There's also a wrapper client.query if there is no need to pass variables

use gql_client::Client;
use serde::{Deserialize, Serialize};
#[derive(Deserialize)] pub struct Data {     user: User }
#[derive(Deserialize)] pub struct User {     id: String,     name: String }
#[derive(Serialize)] pub struct Vars {     id: u32 }
#[tokio::main] async fn main() -> Result<(), Box<dyn std::error::Error>> {     let endpoint = "https://graphqlzero.almansi.me/api";     let query = r#"         query UserByIdQuery($id: ID!) {             user(id: $id) {                 id                 name             }         }     "#;
let client = Client::new(endpoint);     let vars = Vars { id: 1 };     let data = client.querywithvars::<Data, Vars>(query, vars).await.unwrap().unwrap();
println!("Id: {}, Name: {}", data.user.id, data.user.name);
Ok(()) }

Passing HTTP headers

Client exposes newwithheaders function to pass headers using simple HashMap<&str, &str>

use gql_client::Client;
use std::collections::HashMap;
#[tokio::main] async fn main() -> Result<(), Box<dyn std::error::Error>> {     let endpoint = "https://graphqlzero.almansi.me/api";     let mut headers = HashMap::new();     headers.insert("authorization", "Bearer <some_token>");
let client = Client::newwithheaders(endpoint, headers);
Ok(()) }

Error handling

There are two types of errors that can possibly occur. HTTP related errors (for example, authentication problem) or GraphQL query errors in JSON response. Debug, Display implementation of GraphQLError struct properly displays those error messages. Additionally, you can also look at JSON content for more detailed output by calling err.json()

use gql_client::Client;
use serde::{Deserialize, Serialize};
#[derive(Deserialize)] pub struct Data {     user: User }
#[derive(Deserialize)] pub struct User {     id: String,     name: String }
#[derive(Serialize)] pub struct Vars {     id: u32 }
#[tokio::main] async fn main() -> Result<(), Box<dyn std::error::Error>> {     let endpoint = "https://graphqlzero.almansi.me/api";
// Send incorrect request     let query = r#"         query UserByIdQuery($id: ID!) {             user(id: $id) {                 id1                 name             }         }     "#;
let client = Client::new(endpoint);     let vars = Vars { id: 1 };     let error = client.querywithvars::<Data, Vars>(query, vars).await.err();
println!("{:?}", error);
Ok(()) }

🔗 More in this category