Sample code showing how to use quicktype for GraphQL
Switch branches/tags
Nothing to show
Clone or download
Latest commit c86ed71 Dec 20, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode Initial commit Dec 19, 2017
csharp Initial commit Dec 19, 2017
schema Initial commit Dec 19, 2017
typescript npm start instead of npm run run Dec 20, 2017
.gitignore Initial commit Dec 19, 2017
README.md Update README Dec 20, 2017
setup.sh Print quicktype invocation. Fixes #1 Dec 20, 2017

README.md

Use quicktype to make statically typed GraphQL queries

The samples in this repository demonstrate how to use quicktype to do statically typed GraphQL queries to the GitHub API.

With traditional REST APIs, you have to make multiple queries to collect the data needed by your app. For example, to get the followers for all of a user’s GitHub repos, you’d first query for a list of the user’s repos, then perform a query for each repo to get the followers. For a user with n repos, that’s n+1 queries, which means your app will be slow and will need a cumbersome UI (e.g. loading spinners, lazy lists).

With GraphQL, on the other hand, you specify exactly what information you want up front, so you get all the data your app needs in a single query. Given a bunch of those queries, quicktype can generate the exact static types for the responses from the server.

Folders

  • schema contains all the input files for quicktype. Most importantly, there's the GraphQL query. The setup script will also download the GraphQL schema into this folder. The file request.schema contains a JSON Schema definition of the very simple JSON that's used to send the GraphQL query to the server.

  • csharp and typescript contain the code and project files for the C# and TypeScript samples, respectively. The setup script will also invoke quicktype to generate code into those folders.

MacOS and Linux

Install quicktype

First, make sure you have quicktype installed. On MacOS you can install it via Homebrew like this:

brew install quicktype

If you're on Linux, or you prefer NPM:

npm install -g quicktype

Get an authentication token

Follow these steps to generate an authentication token and write it into the file auth-token:

echo TOKEN >auth-token

Run the setup script

./setup.sh

You should see it downloading the GraphQL schema and then generating code.

Try the samples

To run the C# sample with .NET Core, do

cd csharp
dotnet run

For the TypeScript sample, do

cd typescript
npm install
npm start