GraphQL server library for Rust
Find a file
2023-10-13 19:39:56 +03:00
.github Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
assets/logo Logo: move to /assets and add to readme. 2017-09-23 19:13:13 +02:00
benches Upgrade criterion crate to 0.5 version (#1166) 2023-07-06 15:30:35 +00:00
book Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
juniper Fix bigdecimal crate surviving minimal versions check 2023-10-13 19:39:56 +03:00
juniper_actix Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
juniper_codegen Correct fully qualified paths in generated code (#1195, #1194) 2023-10-13 19:28:42 +03:00
juniper_graphql_transport_ws Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
juniper_graphql_ws Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
juniper_hyper Fix operation_name not being set in juniper_hyper (#1169, #1187) 2023-09-12 14:45:56 +02:00
juniper_iron Bump up MSRV to 1.65.0 2022-12-19 09:31:23 +01:00
juniper_rocket Clippy fixes (#1181) 2023-08-25 22:48:01 +00:00
juniper_subscriptions Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
juniper_warp Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
tests Use fully qualified paths in generated code (#1195) 2023-10-06 11:59:00 -07:00
.gitignore Rework CI and project toolchain (#1043) 2022-04-08 17:44:50 +03:00
.rustfmt.toml Rework CI and project toolchain (#1043) 2022-04-08 17:44:50 +03:00
Cargo.toml Improve WebSocket integration (#1191, #1022) 2023-09-21 23:24:41 +02:00
CONTRIBUTING.md Improve project toolchain (#1084) 2022-07-20 10:37:58 +00:00
LICENSE Initial import 2016-09-11 18:41:29 +02:00
Makefile Update GraphQL Playground to 1.7.28 version (#1190, #1069) 2023-09-13 17:10:49 +00:00
README.md Update Gitter link in README.md (#1175) 2023-08-24 18:40:15 -04:00
release.toml Improve CI (#1113) 2022-10-21 16:07:17 +00:00
RELEASING.md Rework CI and project toolchain (#1043) 2022-04-08 17:44:50 +03:00

Juniper

GraphQL server library for Rust

Build Status codecov Crates.io Gitter chat


GraphQL is a data query language developed by Facebook intended to serve mobile and web application frontends.

Juniper makes it possible to write GraphQL servers in Rust that are type-safe and blazingly fast. We also try to make declaring and resolving GraphQL schemas as convenient as Rust will allow.

Juniper does not include a web server - instead it provides building blocks to make integration with existing servers straightforward. It optionally provides a pre-built integration for the Actix, Hyper, Iron, Rocket, and Warp frameworks, including embedded Graphiql and GraphQL Playground for easy debugging.

The book is also available for the master branch and older versions published after 0.11.1. See the book index.

Getting Started

The best place to get started is the Juniper Book, which contains guides with plenty of examples, covering all features of Juniper. (very much WIP)

To get started quickly and get a feel for Juniper, check out the Quickstart section.

For specific information about macros, types and the Juniper api, the API Reference is the best place to look.

You can also check out the Star Wars schema to see a complex example including polymorphism with traits and interfaces. For an example of web framework integration, see the actix, hyper, rocket, iron, and warp examples folders.

Features

Juniper supports the full GraphQL query language according to the specification (October 2021), including interfaces, unions, schema introspection, and validations. It can also output the schema in the GraphQL Schema Language.

As an exception to other GraphQL libraries for other languages, Juniper builds non-null types by default. A field of type Vec<Episode> will be converted into [Episode!]!. The corresponding Rust type for e.g. [Episode] would be Option<Vec<Option<Episode>>>.

Juniper is agnostic to serialization format and network transport.

Juniper supports both asynchronous and synchronous execution using execute() and execute_sync() respectively. Asynchronous execution is runtime agnostic.

Juniper follows a code-first approach to defining GraphQL schemas. If you would like to use a schema-first approach instead, consider juniper-from-schema for generating code from a schema file.

Integrations

Data types

Juniper has automatic integration with some very common Rust crates to make building schemas a breeze. The types from these crates will be usable in your Schemas automatically.

Web Frameworks

Guides & Examples

API Stability

Juniper has not reached 1.0 yet, thus some API instability should be expected.