Skip to content
GraphQL server library for Rust
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
_build Bump min rust version to 1.30.0 Dec 18, 2018
assets/logo Logo: move to /assets and add to readme. Sep 23, 2017
benches Add type alias for query variables Jan 15, 2017
integration_tests
juniper Add Object::iter(_mut) return type change to changelog. Mar 8, 2019
juniper_codegen
juniper_hyper Disable juniper_hyper testing due to rustc bug. Mar 6, 2019
juniper_iron Add GraphQL Playground integration (#317) Jan 26, 2019
juniper_rocket Add GraphQL Playground integration (#317) Jan 26, 2019
juniper_warp Fix juniper_warp example path (#323) Feb 20, 2019
.gitignore
.travis.yml Bump min rust version to 1.30.0 Dec 18, 2018
Cargo.toml
LICENSE Initial import Sep 11, 2016
Makefile.toml Set up some release automation. Dec 17, 2018
README.md
azure-pipelines.yml Fix Azure Pipelines formatting job display name Jan 10, 2019

README.md

Juniper

GraphQL server library for Rust

Build Status 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 possible 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 Hyper, Iron, Rocket, and Warp frameworks, including embedded Graphiql and GraphQL Playground for easy debugging.

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 src/tests/schema.rs to see a complex schema including polymorphism with traits and interfaces. For an example of web framework integration, see the hyper, rocket, iron, and warp examples folders.

Features

Juniper supports the full GraphQL query language according to the specification, including interfaces, unions, schema introspection, and validations. It does not, however, support the 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>>>.

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.

You can’t perform that action at this time.