2020-05-31 19:00:19 +00:00
|
|
|
# A GraphQL server library implemented in Rust
|
2020-03-01 13:56:14 +00:00
|
|
|
|
|
|
|
<div align="center">
|
|
|
|
<!-- CI -->
|
2020-04-28 07:41:31 +00:00
|
|
|
<img src="https://github.com/async-graphql/async-graphql/workflows/CI/badge.svg" />
|
2020-04-05 08:22:13 +00:00
|
|
|
<!-- codecov -->
|
2020-06-02 01:31:13 +00:00
|
|
|
<img src="https://codecov.io/gh/async-graphql/async-graphql/branch/master/graph/badge.svg" />
|
2020-03-01 13:56:14 +00:00
|
|
|
<!-- Crates version -->
|
|
|
|
<a href="https://crates.io/crates/async-graphql">
|
|
|
|
<img src="https://img.shields.io/crates/v/async-graphql.svg?style=flat-square"
|
|
|
|
alt="Crates.io version" />
|
|
|
|
</a>
|
|
|
|
<!-- Downloads -->
|
|
|
|
<a href="https://crates.io/crates/async-graphql">
|
|
|
|
<img src="https://img.shields.io/crates/d/async-graphql.svg?style=flat-square"
|
|
|
|
alt="Download" />
|
|
|
|
</a>
|
|
|
|
<!-- docs.rs docs -->
|
|
|
|
<a href="https://docs.rs/async-graphql">
|
|
|
|
<img src="https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square"
|
|
|
|
alt="docs.rs docs" />
|
|
|
|
</a>
|
2020-11-05 19:50:43 +00:00
|
|
|
<a href="https://github.com/rust-secure-code/safety-dance/">
|
|
|
|
<img src="https://img.shields.io/badge/unsafe-forbidden-success.svg?style=flat-square"
|
|
|
|
alt="Unsafe Rust forbidden" />
|
|
|
|
</a>
|
2020-03-01 13:56:14 +00:00
|
|
|
</div>
|
|
|
|
|
2020-05-03 13:46:38 +00:00
|
|
|
`Async-graphql` is a high-performance server-side library that supports all GraphQL specifications.
|
2020-03-12 09:21:49 +00:00
|
|
|
|
2020-05-03 13:46:38 +00:00
|
|
|
* [Feature Comparison](feature-comparison.md)
|
2020-05-10 01:41:13 +00:00
|
|
|
* [Book](https://async-graphql.github.io/async-graphql/en/index.html)
|
|
|
|
* [中文文档](https://async-graphql.github.io/async-graphql/zh-CN/index.html)
|
2020-03-21 07:11:46 +00:00
|
|
|
* [Docs](https://docs.rs/async-graphql)
|
2020-04-28 07:41:31 +00:00
|
|
|
* [GitHub repository](https://github.com/async-graphql/async-graphql)
|
2020-03-01 13:56:14 +00:00
|
|
|
* [Cargo package](https://crates.io/crates/async-graphql)
|
2021-04-03 05:39:18 +00:00
|
|
|
* Minimum supported Rust version: 1.50.0 or later
|
2020-03-01 13:56:14 +00:00
|
|
|
|
2020-05-29 09:33:19 +00:00
|
|
|
## Safety
|
|
|
|
|
2020-06-03 11:33:32 +00:00
|
|
|
This crate uses `#![forbid(unsafe_code)]` to ensure everything is implemented in 100% Safe Rust.
|
2020-05-29 09:33:19 +00:00
|
|
|
|
2020-06-02 23:46:34 +00:00
|
|
|
## Features
|
|
|
|
|
2020-07-07 09:03:01 +00:00
|
|
|
* Fully supports async/await
|
2020-06-02 23:46:34 +00:00
|
|
|
* Type safety
|
|
|
|
* Rustfmt friendly (Procedural Macro)
|
2020-07-07 09:03:01 +00:00
|
|
|
* Custom scalars
|
2020-06-02 23:46:34 +00:00
|
|
|
* Minimal overhead
|
2020-09-14 06:13:43 +00:00
|
|
|
* Easy integration (actix_web, tide, warp, rocket ...)
|
2020-06-02 23:46:34 +00:00
|
|
|
* Upload files (Multipart request)
|
2020-07-07 09:03:01 +00:00
|
|
|
* Subscriptions (WebSocket transport)
|
|
|
|
* Custom extensions
|
2020-06-02 23:46:34 +00:00
|
|
|
* Apollo Tracing extension
|
|
|
|
* Limit query complexity/depth
|
|
|
|
* Error Extensions
|
|
|
|
* Apollo Federation
|
2020-09-17 08:39:55 +00:00
|
|
|
* Batch Queries
|
2020-09-30 03:44:18 +00:00
|
|
|
* Apollo Persisted Queries
|
2020-09-26 03:25:21 +00:00
|
|
|
|
2021-03-22 02:39:17 +00:00
|
|
|
## Crate features
|
|
|
|
|
|
|
|
This crate offers the following features, all of which are not activated by default:
|
|
|
|
|
|
|
|
- `apollo_tracing`: Enable the [Apollo tracing extension](extensions/struct.ApolloTracing.html).
|
|
|
|
- `apollo_persisted_queries`: Enable the [Apollo persisted queries extension](extensions/apollo_persisted_queries/struct.ApolloPersistedQueries.html).
|
|
|
|
- `log`: Enable the [logger extension](extensions/struct.Logger.html).
|
|
|
|
- `tracing`: Enable the [tracing extension](extensions/struct.Tracing.html).
|
|
|
|
- `opentelemetry`: Enable the [OpenTelemetry extension](extensions/struct.OpenTelemetry.html).
|
|
|
|
- `unblock`: Support [asynchronous reader for Upload](types/struct.Upload.html)
|
|
|
|
- `bson`: Integrate with the [`bson` crate](https://crates.io/crates/bson).
|
|
|
|
- `chrono`: Integrate with the [`chrono` crate](https://crates.io/crates/chrono).
|
|
|
|
- `chrono-tz`: Integrate with the [`chrono-tz` crate](https://crates.io/crates/chrono-tz).
|
|
|
|
- `url`: Integrate with the [`url` crate](https://crates.io/crates/url).
|
|
|
|
- `uuid`: Integrate with the [`uuid` crate](https://crates.io/crates/uuid).
|
|
|
|
- `string_number`: Enable the [StringNumber](types/struct.StringNumber.html).
|
|
|
|
- `dataloader`: Support [DataLoader](dataloader/struct.DataLoader.html).
|
2021-05-11 00:48:54 +00:00
|
|
|
- `secrecy`: Integrate with the [`secrecy` crate](https://crates.io/crates/secrecy).
|
2021-03-22 02:39:17 +00:00
|
|
|
|
2020-04-14 01:53:17 +00:00
|
|
|
## Examples
|
2020-03-09 12:44:31 +00:00
|
|
|
|
2020-10-16 01:21:16 +00:00
|
|
|
All examples are in the [sub-repository](https://github.com/async-graphql/examples), located in the examples directory.
|
|
|
|
|
|
|
|
**Run an example:**
|
|
|
|
|
|
|
|
```shell
|
|
|
|
git submodule update # update the examples repo
|
|
|
|
cd examples && cargo run --bin [name]
|
|
|
|
```
|
2020-03-09 12:44:31 +00:00
|
|
|
|
2020-03-18 00:44:41 +00:00
|
|
|
## Integrations
|
|
|
|
|
2020-03-18 03:13:45 +00:00
|
|
|
* Actix-web [async-graphql-actix-web](https://crates.io/crates/async-graphql-actix-web)
|
2020-04-14 03:44:08 +00:00
|
|
|
* Warp [async-graphql-warp](https://crates.io/crates/async-graphql-warp)
|
2020-04-26 15:10:16 +00:00
|
|
|
* Tide [async-graphql-tide](https://crates.io/crates/async-graphql-tide)
|
2020-09-14 08:46:15 +00:00
|
|
|
* Rocket [async-graphql-rocket](https://github.com/async-graphql/async-graphql/tree/master/integrations/rocket)
|
2020-03-18 00:44:41 +00:00
|
|
|
|
2020-03-03 03:48:00 +00:00
|
|
|
## License
|
|
|
|
|
|
|
|
Licensed under either of
|
|
|
|
|
|
|
|
* Apache License, Version 2.0,
|
2021-04-19 14:38:46 +00:00
|
|
|
([LICENSE-APACHE](./LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
|
|
|
|
* MIT license ([LICENSE-MIT](./LICENSE-MIT) or http://opensource.org/licenses/MIT)
|
2020-03-03 03:48:00 +00:00
|
|
|
at your option.
|
2020-03-01 14:13:37 +00:00
|
|
|
|
2020-03-01 13:56:14 +00:00
|
|
|
## References
|
|
|
|
|
|
|
|
* [GraphQL](https://graphql.org)
|
2020-03-19 09:20:12 +00:00
|
|
|
* [GraphQL Multipart Request](https://github.com/jaydenseric/graphql-multipart-request-spec)
|
|
|
|
* [GraphQL Cursor Connections Specification](https://facebook.github.io/relay/graphql/connections.htm)
|
|
|
|
* [GraphQL over WebSocket Protocol](https://github.com/apollographql/subscriptions-transport-ws/blob/master/PROTOCOL.md)
|
2020-03-26 03:34:28 +00:00
|
|
|
* [Apollo Tracing](https://github.com/apollographql/apollo-tracing)
|
2020-04-10 02:28:27 +00:00
|
|
|
* [Apollo Federation](https://www.apollographql.com/docs/apollo-server/federation/introduction)
|
2020-03-22 08:45:59 +00:00
|
|
|
|
|
|
|
## Contribute
|
|
|
|
|
2020-05-25 21:37:46 +00:00
|
|
|
Welcome to contribute !
|