A GraphQL server library implemented in Rust

Async-graphql is a high-performance server-side library that supports all GraphQL specifications.

Feature Comparison
Book
中文文档
Docs
GitHub repository
Cargo package
Minimum supported Rust version: 1.54.0 or later

Safety

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

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
Apollo Tracing extension
Limit query complexity/depth
Error Extensions
Apollo Federation
Batch Queries
Apollo Persisted Queries

Crate features

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

apollo_tracing: Enable the Apollo tracing extension.
apollo_persisted_queries: Enable the Apollo persisted queries extension.
log: Enable the logger extension.
tracing: Enable the tracing extension.
opentelemetry: Enable the OpenTelemetry extension.
unblock: Support asynchronous 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.
string_number: Enable the StringNumber.
dataloader: Support DataLoader.
secrecy: Integrate with the secrecy crate.
decimal: Integrate with the rust_decimal crate.
cbor: Support for serde_cbor.

Apollo Studio

Apollo Studio is a cloud platform that helps you build, monitor, validate, and secure your organization's data graph. An existing extension is available for this crate here

Examples

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

Run an example:

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

Integrations

About actix-web-v4: The beta version is supported in the branch actix-web-beta Related Issue

Who's using Async-graphql in production?

Community Showcase

rust-actix-graphql-sqlx-postgresql Using 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

Blog Posts

License

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

References

Contribute

Welcome to contribute !

oeed/async-graphql