[−][src]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
Apollo Persisted Queries

Crate features

This crate offers the following features, all of which are 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.
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

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

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 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

Macros

value

Structs

CacheControl	Cache control values
ContextBase	Query context
Data	Schema/Context data.
Error	An error with a message and optional extensions.
ErrorExtensionValues	Extensions to the error.
InputValueError	An error parsing an input value.
Lookahead	A selection performed by a query.
Name
Number
QueryPathNode	The query path node
Request	GraphQL request.
ResolveId	Represents the unique id of the resolve
Response	Query response
Schema	GraphQL schema.
SchemaBuilder	Schema builder
ServerError	An error in a GraphQL server.
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
DeserializerError
ParseRequestError	An error parsing the request.
PathSegment	A segment of path to a resolver.
QueryPathSegment	The query path segment
SerializerError
ValidationMode	Validation mode
Value

Traits

ContainerType	A GraphQL container.
EnumType	A GraphQL enum.
ErrorExtensions	An error which can be extended into a `FieldError`.
InputObjectType	A GraphQL input object.
InputValueType	Represents a GraphQL input value
InterfaceType	A GraphQL interface.
ObjectType	A GraphQL object.
OutputValueType	Represents a GraphQL output value
ResultExt	Extend a `Result`'s error value with `ErrorExtensions`.
ScalarType	A GraphQL scalar.
Type	Represents a GraphQL type
UnionType	A GraphQL interface.

Functions

from_value
to_value

Type Definitions

Context	Context object for resolve field
InputValueResult	An error parsing a value of type `T`.
Result	An alias for `Result<T, Error>`.
ServerResult	Alias for `Result<T, ServerError>`.

Attribute Macros

Object
Scalar
Subscription

Derive Macros

Enum
InputObject
Interface
MergedObject
MergedSubscription
SimpleObject
Union