a high-performance graphql server library that's fully specification compliant

Book •中文文档 •Docs •GitHub repository •Cargo package

This crate uses#![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

Static schema

use std::error::Error;use async_graphql::{http::GraphiQLSource,EmptyMutation,EmptySubscription,Object,Schema};use async_graphql_poem::*;use poem::{listener::TcpListener, web::Html,*};structQuery;#[Object]implQuery{asyncfnhowdy(&self) ->&'staticstr{"partner"}}#[handler]asyncfngraphiql() ->implIntoResponse{Html(GraphiQLSource::build().finish())}#[tokio::main]asyncfnmain() ->Result<(),Box<dynError>>{// create the schemalet schema =Schema::build(Query,EmptyMutation,EmptySubscription).finish();// start the http serverlet app =Route::new().at("/",get(graphiql).post(GraphQL::new(schema)));println!("GraphiQL: http://localhost:8000");Server::new(TcpListener::bind("0.0.0.0:8000")).run(app).await?;Ok(())}

Dynamic schema

use std::error::Error;use async_graphql::{dynamic::*, http::GraphiQLSource};use async_graphql_poem::*;use poem::{listener::TcpListener, web::Html,*};#[handler]asyncfngraphiql() ->implIntoResponse{Html(GraphiQLSource::build().finish())}#[tokio::main]asyncfnmain() ->Result<(),Box<dynError>>{let query =Object::new("Query").field(Field::new("howdy",TypeRef::named_nn(TypeRef::STRING),        |_|FieldFuture::new(async{"partner"}),));// create the schemalet schema =Schema::build(query,None,None).register(query).finish()?;// start the http serverlet app =Route::new().at("/",get(graphiql).post(GraphQL::new(schema)));println!("GraphiQL: http://localhost:8000");Server::new(TcpListener::bind("0.0.0.0:8000")).run(app).await?;Ok(())}

⚠️Security

Features

Examples

git submodule update# update the examples repocd examples&& cargo run --bin [name]

Integrations

Crate features

Observability

Who's usingasync-graphql in production?

Community Showcase

Blog Posts

References

License