graphql_ppx

GraphQL PPX rewriter for Bucklescript/ReasonML
README

Go to the official documentation

Features

  • Language level GraphQL primitives

  • Building block for GraphQL clients

  • 100% type safe

Installation

Schema

graphql-ppx needs your graphql schema to be available in the form of a
graphql_schema.json file.

The easiest way to add this to your project is using an
introspection query
to your backend. You can do this using get-graphql-schema:

npx get-graphql-schema ENDPOINT_URL -j > graphql_schema.json

With ENDPOINT_URL being the URL of your GraphQL endpoint.

Cache

graphql-ppx will generate a .graphql_ppx_cache folder alongside your JSON
schema to optimize parsing performance. If you're using a version control
system, you don't need to check it in.

The next pages will provide further installation instructions whether you are
using graphql-ppx with Bucklescript or using Reason Native.

Bucklescript

First, add it to you dependencies using npm or yarn:

yarn add @reasonml-community/graphql-ppx@next --dev
# or
npm install @reasonml-community/graphql-ppx@next  --saveDev

Second, add it to ppx-flags and bs-dependencies in your bsconfig.json:

"ppx-flags": ["@reasonml-community/graphql-ppx/ppx"],
"bs-dependencies": ["@reasonml-community/graphql-ppx"]

Native

Caution!

The Bucklescript version of graphql-ppx was almost completely rewritten for the
1.0 release, with many improvements and changes. This documentation will focus
on the API of the bucklescript version. This means that most of the examples
won't apply for the Reason Native version. Please take a look at the
old documentation.
At the same time we welcome contributions to modernize the Reason Native version
of graphql-ppx
:::

You need to provide the following dependency in your esy.json file

{
  "dependencies": {
    "graphql-ppx": "*"
  },
  "resolutions": {
    "graphql-ppx": "reasonml-community/graphql-ppx:esy.json#<use latest stable commit from master>"
  }
}

and update your dune file:

(preprocess (pps graphql_ppx))

Usage

Make your first query:

[%graphql {|
  query UserQuery {
    user {
      id
      name
    }
  }
|}];

Open getting started in the docs

Roadmap

See our development board for a list of selected features and issues.

Contributing

We'd love your help improving graphql-ppx!

Take a look at our Contributing Guide to get started.

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgements

Thanks to everyone who contributed to graphql-ppx!

This project builds upon mhallin/graphql_ppx. It wouldn't be possible without
great work of mhallin/graphql_ppx contributors.
1

Install
Published
12 Sep 2020
Sources
v1.0.1.tar.gz
md5=bcf43590b569405282f698ad5bdb45f9
sha512=644479f8fc2760cf202c4bce04cb5cf6e1a8f38fcc9a68583c92b8c4fe614c58d4d28e29a21935ef01f3b049d3ebea14ae6eaebf01000ec2a69cf62105338d8a
Dependencies
Reverse Dependencies