Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 2,364 Commits
.github		.github
derive		derive
docs		docs
examples @ 16139cc		examples @ 16139cc
integrations		integrations
parser		parser
src		src
tests		tests
value		value
.gitignore		.gitignore
.gitmodules		.gitmodules
.rustfmt.toml		.rustfmt.toml
ARCHITECTURE.md		ARCHITECTURE.md
CHANGELOG.md		CHANGELOG.md
Cargo.toml		Cargo.toml
LICENSE-APACHE		LICENSE-APACHE
LICENSE-MIT		LICENSE-MIT
README.md		README.md
SECURITY.md		SECURITY.md

Repository files navigation

async-graphql

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.

structQuery;#[Object]implQuery{fnhowdy(&self) ->&'staticstr{"partner"}}asyncfnmain(){let schema =Schema::build(Query,EmptyMutation,EmptySubscription).finish();let 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.unwrap();}

Features

Fully supports async/await
Type safety
Rustfmt friendly (Procedural Macro)
Custom scalars
Minimal overhead
Easy integration (poem, actix_web, tide, warp, rocket ...)
Upload files (Multipart request)
Subscriptions (WebSocket transport)
Custom extensions
Error extensions
Limit query complexity/depth
Batch queries
Apollo Persisted Queries
Apollo Tracing extension
Apollo Federation(v2)

Note: Minimum supported Rust version: 1.59.0 or later

Examples

All examples are in thesub-repository, located in the examples directory.

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

Integrations

Integrations are what glueasync-graphql with your web server, here are provided ones, or you can build your own!

Crate features

This crate offers the following features, all of which are not activated by default:

feature	enables
`apollo_tracing`	Enable theApollo tracing extension.
`apollo_persisted_queries`	Enable theApollo persisted queries extension.
`log`	Enable theLogger extension.
`tracing`	Enable theTracing extension.
`opentelemetry`	Enable theOpenTelemetry extension.
`unblock`	SupportAsynchronous reader for Upload
`bson`	Integrate with the`bson` crate.
`chrono`	Integrate with the`chrono` crate.
`chrono-tz`	Integrate with the`chrono-tz` crate.
`url`	Integrate with the`url` crate.
`uuid`	Integrate with the`uuid` crate.
`uuid08`	Integrate with the`uuid 0.8` crate.
`string_number`	Enable theStringNumber.
`dataloader`	SupportDataLoader.
`secrecy`	Integrate with the`secrecy` crate.
`decimal`	Integrate with the`rust_decimal` crate.
`bigdecimal`	Integrate with the`bigdecimal` crate.
`cbor`	Support forserde_cbor.
`smol_str`	Integrate with the`smol_str` crate.
`hashbrown`	Integrate with the`hashbrown` crate.
`time`	Integrate with the`time` crate.
`tokio-sync`	Integrate with the`tokio::sync::RwLock` and`tokio::sync::Mutex`.
`fast_chemail`	Integrate with the`fast_chemail` crate.

Observability

One of the tools used to monitor your graphql server in production is Apollo Studio. Apollo Studio is a cloud platform that helps you build, monitor, validate, and secure your organization's data graph.Add the extension crateasync_graphql_apollo_studio_extension to make this avaliable.

Who's using`async-graphql` in production?

Community Showcase

rust-actix-graphql-sqlx-postgresqlUsing GraphQL with Rust and Apollo Federation
entity-rs A simplistic framework based on TAO, Facebook's distributed database for Social Graph.
vimwiki-server Provides graphql server to inspect and manipulate vimwiki files.
Diana Diana is a GraphQL system for Rust that's designed to work as simply as possible out of the box, without sacrificing configuration ability.
cindythink
sudograph