yume/juniper
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
GraphQL server library for Rust
288 commits 5 branches 139 tags 21 MiB
Rust 99%
HTML 0.8%
Makefile 0.2%
Find a file
Josh Marlow b1543f480a Fixed case where .unwrap was being called instead of the Option just being propagated up the call chain
2018-01-13 08:20:51 +00:00
_build Get travis to upload documentation to gh-pages branch 2016-09-11 20:31:16 +02:00
assets/logo Logo: move to /assets and add to readme. 2017-09-23 19:13:13 +02:00
benches Add type alias for query variables 2017-01-15 13:37:30 -06:00
changelog Remove ResultExt and jtry! macro 2017-12-03 18:33:35 +01:00
juniper Fixed case where .unwrap was being called instead of the Option just being propagated up the call chain 2018-01-13 08:20:51 +00:00
juniper_codegen Bump to 0.9.1 and fix up Cargo.toml files 2017-12-03 18:48:38 +01:00
juniper_iron Bump to 0.9.1 and fix up Cargo.toml files 2017-12-03 18:48:38 +01:00
juniper_rocket Update rocket in juniper_rocket to work with latest nightlies 2018-01-13 07:50:33 +00:00
juniper_tests Fix some warnings 2018-01-13 07:48:39 +00:00
.gitignore Initial import 2016-09-11 18:41:29 +02:00
.travis.yml (ci) Fix deployment via travis 2017-12-03 17:00:39 +01:00
appveyor.yml (ci) Drop 32bit builds on appveyor 2017-12-03 13:14:29 +01:00
Cargo.toml Fix up Cargo.toml files and documentation. 2017-12-02 18:33:20 +01:00
LICENSE Initial import 2016-09-11 18:41:29 +02:00
Makefile.toml v09 build fix for windows (#115) 2017-12-03 10:31:56 +01:00
README.md Fix test schema link in README 2017-12-26 08:03:40 +01:00

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 Iron and Rocket frameworks, including embedded Graphiql 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 rocket and iron 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

API Stability

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