Crate async_graphql

A GraphQL server library implemented in Rust

Documentation

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

Features

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

Crate features

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

• apollo_tracing: Enable the Apollo tracing extension.
• log: Enable the logger extension.
• tracing: Enable the tracing extension.
• multipart: Support sending files over HTTP multipart.
• 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.

Integrations

• Actix-web async-graphql-actix_web
• Warp async-graphql-warp
• Tide async-graphql-tide

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

• GraphQL
• GraphQL Multipart Request
• GraphQL Cursor Connections Specification
• GraphQL over WebSocket Protocol
• Apollo Tracing
• Apollo Federation

Examples

If you are just getting started, we recommend checking out our examples at: https://github.com/async-graphql/examples

To see how you would create a Relay-compliant server using async-graphql, warp, diesel & postgresql, you can also check out a real-world example at: https://github.com/phated/twentyfive-stars

Benchmarks

Ensure that there is no CPU-heavy process in background!

cd benchmark
cargo bench

Now a HTML report is available at benchmark/target/criterion/report.

Re-exports

pub use async_graphql_parser as parser;

pub use parser::Pos;

pub use parser::Positioned;

pub use resolver_utils::EnumType;

pub use resolver_utils::ObjectType;

pub use resolver_utils::ScalarType;

pub use types::*;

Modules

extensions	Extensions for schema
guard	Field guards
http	A helper module that supports HTTP
resolver_utils	Utilities for implementing OutputValueType::resolve.
types	Useful GraphQL types.
validators	Input value validators

Structs

CacheControl	Cache control values
ContextBase	Query context
Data	Schema/Context data.
FieldError	An error in a field resolver.
Lookahead	A selection performed by a query.
Number	Represents a JSON number, whether integer or floating point.
QueryPathNode	The query path node
Request	GraphQL request.
ResolveId	Represents the unique id of the resolve
Response	Query response
RuleError	Verification error.
Schema	GraphQL schema.
SchemaBuilder	Schema builder
Variables	Variables of a query.

Enums

BatchRequest	Batch support for GraphQL requests, which is either a single query, or an array of queries
BatchResponse	Response for batchable queries
Error	An error serving a GraphQL query.
InputValueError	An error in the format of an input value.
ParseRequestError	An error parsing the request.
QueryError	An error processing a GraphQL query.
QueryPathSegment	The query path segment
ValidationMode	Validation mode
Value	A resolved GraphQL value, for example 1 or "Hello World!".

Traits

ErrorExtensions	An error which can be extended into a FieldError.
InputValueType	Represents a GraphQL input value
OutputValueType	Represents a GraphQL output value
ResultExt	Extend a Result's error value with ErrorExtensions.
Type	Represents a GraphQL type

Type Definitions

Context	Context object for resolve field
FieldResult	An alias for Result<T, FieldError>.
InputValueResult	An alias for Result<T, InputValueError>.
Result	Result type

Attribute Macros

Object	Define a GraphQL object with methods
Scalar	Define a Scalar
Subscription	Define a GraphQL subscription

Derive Macros

Enum	Define a GraphQL enum
InputObject	Define a GraphQL input object
Interface	Define a GraphQL interface
MergedObject	Define a merged object with multiple object types.
MergedSubscription	Define a merged subscription with multiple subscription types.
SimpleObject	Define a GraphQL object with fields
Union	Define a GraphQL union