Skip to content
main
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 

README.md

GraphQuill

What is GraphQuill?

GraphQuill is a VS Code extension that performs GraphQL API endpoint testing within the VS Code environment. GraphQuill intends to remove the need for switching between VS Code and GraphiQL, Postman, or another API development tool.

Features

Core Features

  1. Starts your GraphQL server (if it is not already running).
NOTE: GraphQuill is compatible with local and dockerized servers and will check if the specified port has a running server on it.
GraphQuill is also compatible with **external** API's (accessed via a url in the config file).
  1. Parses GraphQL queries/mutations that are typed into the current open document in VS Code.
  2. Sends the queries/mutations to the GraphQL API.
  3. Renders the responses to the GraphQuill output channel on VS Code.

demo gif

Additional Features


Getting Started

Installation

GraphQuill can be installed from the VS Code Extensions marketplace here.

Setting up the config file

Open the command palette in VS Code (Cmd/Ctrl + Shift + P) and select "GraphQuill: Create GraphQuill Config File". A default config file will be generated. If you're using a locally-hosted server, update the entry point with your server's file path and add a port number. If you're using an external server, set the entrypoint to its URL. For more details, refer to the documentation.

GraphQuill's Mock GraphQL API

A GraphQL API that was used during GraphQuill's development has been open sourced in two repositories on Github to allow users to give GraphQuill a test drive. Below are two repositories, one that has been dockerized, and one that uses locally hosted PostgreSQL and MongoDB databases.

The dockerized version is here.

The locally hosted PostgreSQL and MongoDB databases version is here.

Write your first GraphQuill query

Search for GraphQuill from the command palette in VS Code (Cmd/Ctrl + Shift + P) and run the Activate command. If the graphQuill function is not defined, GraphQuill will inject a function definition on the top line of your file.

Anywhere in your open file, put a GraphQL query inside the graphQuill function. For example:

  graphQuill(`{
    customer (customerId: 8) {
      firstName
      lastName
      email
    }  
  }`);

  graphQuill('{ product (productId: 26) { name description weight } }');

On every save, GraphQuill will send any requests inside of the graphQuill functions to your GraphQL API and show responses in the GraphQuill Output Channel. To send another request, create a new invocation of the graphQuill function and put the new request as the argument.


Contributing and Issues

We are always looking to improve. If there are any contributions, feature requests or issues/bugs you have, please check out our documentation on contributions, feature requests or issues/bugs.

Release Notes

Created by: Alex Chao, Austin Ruby and Edward Greenberg

0.16.0 | Initial release of GraphQuill, More to come!

About

Real-time GraphQL API Exploration in VS Code

Resources

License

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  
You can’t perform that action at this time.