The GraphQL server library implemented by rust

async-graphql is a GraphQL server library that fully supports async/await and is easy to use.

It supports all of the GraphQL specifications and is easy to integrate into existing web servers.

• Docs
• GitHub repository
• Cargo package
• Minimum supported Rust version: 1.40 or later

Example

cargo run --example actix-web

Open http://localhost:8000 in browser

Benchmark

git clone https://github.com/sunli829/graphql-benchmark
cargo run --release

Features

• Fully support async/await
• Type safety
• Rustfmt friendly (Procedural Macro)
• Custom scalar
• Minimal overhead
• Easy integration (hyper, actix_web, tide ...)
• Upload files (Multipart request)
• Subscription (WebSocket transport)
• Custom extension
• Apollo Tracing extension
• Limit query complexity/depth
• Error Extensions

Integrations

• Actix-web async-graphql-actix-web

Goals

• Types
  • Scalar
    • Integer
    • Float
    • String
    • Bool
    • ID
    • DateTime
    • UUID
    • Url
    • ObjectId
  • Containers
    • List
    • Non-Null
  • Object
  • Enum
  • InputObject
    • Field default value
    • Deprecated flag
  • Interface
  • Union
• Query
  • Fields
  • Arguments
    • Default value
    • Deprecated flag
  • Alias
  • Fragments
  • Inline fragments
  • Operation name
  • Variables
    • Default value
    • Parse value
  • Directives
    • @include
      • FIELD
      • FRAGMENT_SPREAD
      • INLINE_FRAGMENT
    • @skip
      • FIELD
      • FRAGMENT_SPREAD
      • INLINE_FRAGMENT
  • Introspection
    • Query
    • Disable introspection
  • Multipart Request
  • Cursor Connections
  • Input value validators
    • Custom validator
    • Combination
      • and
      • or
    • Integer
      • IntRange
      • IntLessThan
      • IntGreaterThan
      • IntNonZero
    • String
      • Email
      • MAC
      • StringMinLength
      • StringMaxLength
    • List
      • ListMaxLength
      • ListMinLength
  • Limit query complexity
  • Limit query depth
• Extensions
  • Custom
  • Apollo tracing
• Subscription
  • Filter
  • WebSocket transport
• Validation rules
  • ArgumentsOfCorrectType
  • DefaultValuesOfCorrectType
  • FieldsOnCorrectType
  • FragmentsOnCompositeTypes
  • KnownArgumentNames
  • KnownDirectives
  • KnownFragmentNames
  • KnownTypeNames
  • LoneAnonymousOperation
  • NoFragmentCycles
  • NoUndefinedVariables
  • NoUnusedFragments
  • NoUnusedVariables
  • OverlappingFieldsCanBeMerged
  • PossibleFragmentSpreads
  • ProvidedNonNullArguments
  • ScalarLeafs
  • UniqueArgumentNames
  • UniqueFragmentNames
  • UniqueOperationNames
  • UniqueVariableNames
  • VariablesAreInputTypes
  • VariableInAllowedPosition
• Integration examples
  • Actix-web
  • Hyper
  • 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

Contribute

Welcome to contribute !