Awesome Open Source
Awesome Open Source

Gest - A sensible GraphQL testing CLI and tool.

A sensible GraphQL testing tool.

PRs welcome tested with jest tested with gest MIT License


$ npm install -g gest

then send queries with gest (pronounced guest [/Ι‘est/]).

$ gest [options] [query | pathToFileWithQuery]
$ gest '{ test }'


$ gest test.graphql

# with `test.graphql` containing

or multiple

$ gest test.graphql '{ test }' introspection.graphql
# will run all three queries!


If you run gest with no arguments, it will open a REPL for you to run queries in:

$ gest

Query: { test }

  data: {
    test: "success!"


If you specify a baseURL in your config, gest will send an POST request with your query correctly encoded in the body. Your baseURL must be a valid URL.

You can specify HTTP headers by using -H key=value flags.

This is especially convenient if you are using a Now workflow.

$ gest -H Authorization=e130294e --baseURL '{ test }'

Local module

You can use gest as a local module in your unit/integration tests

const Gest = require('gest')
const schema = require('../src/schema')

const gest = Gest(schema, {
  baseURL: '',
  headers: {
    Authorization: 'Bearer token',
    Accept: 'application/json'

describe('GraphQL', () => {
  test('{ test }', () => {
    return gest('{ test }').then(({ data, errors }) => {

or use Global gest with jest.

// will create global `gest()` function

// pass a test name and a query
  'test query',

Note: Global functionality will be turned on by default if NODE_ENV === test and if global.test or exists


--all (-A)

Running gest --all will run all files matching *.query, *.graphql, or *.gql and simply print if each query succeeded without errors

--inspect (-I)

For convenience, running gest --inspect or gest -I will pretty print your GraphQL schema

--print (-P)

Pretty print your GraphQL queries (without using GraphiQL!)

$ gest [query | pathToQuery] --print
$ gest '{test}' --print

--schema (-S)

You can specify the path to your GraphQL schema with gest --schema ./path/to/schema.js

--baseURL (-B)

URL to send GraphQL queries to: gest --baseURL

--header (-H)

HTTP request headers to send with your queries: gest --header Accept=application/json. Headers will be passed into context as context.headers for every query for local testing.


The gest CLI will look to resolve your GraphQL schema in the current working directory for schema.js. If you wish to specify a different schema location, do so as schema in your config.


You can configure the gest runtime by adding a gest key to your package.json, or specifying them as flags.

// package.json
  "name": "your_package",
  "gest": {
    "schema": "./path/to/schema",
    "baseURL": ""

Why gest?

  • πŸ‘ No restarting your dev server when you make changes
  • πŸ‘ Testing your schema doesn't require a separate window (e.g. Graphiql)
  • πŸ‘ Run queries from files (save the queries you use most often)
  • πŸ‘ Simple unit testing for your schema
  • πŸ‘ Easy regression testing with gest --all.
  • πŸ‘ Simple integration/deployment testing with --baseURL
  • πŸ‘ Handy introspection and pretty printing
  • πŸ‘ Helpful error messages!
  • πŸ‘Ž No query autocompletion (yet)


  1. Fork this repository to your own GitHub account and then clone it locally
  2. Install the dependencies: npm install
  3. Run npm link to link the scripts found in bin for testing terminal commands
  4. Before submitting a pull request, run npm test

Need help?

Running gest help will show you all the gest options. If you have any other concerns, post an issue!


The official gest logo is designed by @jakedex



Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (68,686)Β 
cli (1,734)Β 
graphql (1,042)Β 
testing (940)Β 
command-line (519)Β 
jest (274)Β 
test (203)Β 
testing-tools (198)Β 
integration-testing (64)Β 
graphql-client (56)Β 

Find Open Source By Browsing 7,000 Topics Across 59 Categories

Advertising πŸ“¦Β 10
All Projects
Application Programming Interfaces πŸ“¦Β 124
Applications πŸ“¦Β 192
Artificial Intelligence πŸ“¦Β 78
Blockchain πŸ“¦Β 73
Build Tools πŸ“¦Β 113
Cloud Computing πŸ“¦Β 80
Code Quality πŸ“¦Β 28
Collaboration πŸ“¦Β 32
Command Line Interface πŸ“¦Β 49
Community πŸ“¦Β 83
Companies πŸ“¦Β 60
Compilers πŸ“¦Β 63
Computer Science πŸ“¦Β 80
Configuration Management πŸ“¦Β 42
Content Management πŸ“¦Β 175
Control Flow πŸ“¦Β 213
Data Formats πŸ“¦Β 78
Data Processing πŸ“¦Β 276
Data Storage πŸ“¦Β 135
Economics πŸ“¦Β 64
Frameworks πŸ“¦Β 215
Games πŸ“¦Β 129
Graphics πŸ“¦Β 110
Hardware πŸ“¦Β 152
Integrated Development Environments πŸ“¦Β 49
Learning Resources πŸ“¦Β 166
Legal πŸ“¦Β 29
Libraries πŸ“¦Β 129
Lists Of Projects πŸ“¦Β 22
Machine Learning πŸ“¦Β 347
Mapping πŸ“¦Β 64
Marketing πŸ“¦Β 15
Mathematics πŸ“¦Β 55
Media πŸ“¦Β 239
Messaging πŸ“¦Β 98
Networking πŸ“¦Β 315
Operating Systems πŸ“¦Β 89
Operations πŸ“¦Β 121
Package Managers πŸ“¦Β 55
Programming Languages πŸ“¦Β 245
Runtime Environments πŸ“¦Β 100
Science πŸ“¦Β 42
Security πŸ“¦Β 396
Social Media πŸ“¦Β 27
Software Architecture πŸ“¦Β 72
Software Development πŸ“¦Β 72
Software Performance πŸ“¦Β 58
Software Quality πŸ“¦Β 133
Text Editors πŸ“¦Β 49
Text Processing πŸ“¦Β 136
User Interface πŸ“¦Β 330
User Interface Components πŸ“¦Β 514
Version Control πŸ“¦Β 30
Virtualization πŸ“¦Β 71
Web Browsers πŸ“¦Β 42
Web Servers πŸ“¦Β 26
Web User Interface πŸ“¦Β 210