Go Graphql Starter

This project aims to use neelance/graphql-go to build a starter web application. This project would be continuously under development. Pull request is welcome.

RoadMap:

• Integrated with sqlx
• Integrated with graphql-go
• Use go-bindata to generate Go code from .graphql file
• Use psql
• Integrated with dataloader
• Add authentication & authorization
• Add unit test cases
• Support subscription
• Support web-socket notification and messaging

Structure

go-graphql-starer
│   README.md
│   test.db             --- the temporary testing database for demo
│   server.go           --- the entry file
│   Config.toml         --- the configuration file for setting server parameter
│   Dockerfile
│   Gopkg.lock          --- generated file from dependency management tool, dep
│   Gopkg.toml          --- generated file from dependency management tool, dep
│   graphiql.html       --- the html for graphiql which is used for testing query & mutation
└───config              --- configuration utilities like db
└───data                --- storing the sql data patch for different version
│   └───1.0             --- storing sql data patch for version 1.0
│      └───...          --- sql files
└───handler             --- the handler used for chaining http request like authentication, logging etc.
└───loader              --- implementation of dataloader for caching and batching the graphql query
└───model               --- the folder putting struct file
└───resolver            --- implementation of graphql resolvers
└───schema              --- implementation of graphql resolvers
│   │   schema.go       --- used for generate go code from static graphql files inside 'type' folder
│   │   schema.graphql  --- graphql root schema
│   └───type            --- folder for storing graphql schema in *.graphql format
│       └───...         --- graphql schema files in *.graphql format
└───service             --- services for users, authorization etc.
└───util                --- utilities

Usage:

1. Install go-bindata

   go get -u github.com/jteeuwen/go-bindata/...
   

2. Setup GOPATH

   For example: MacOS

   export GOPATH=/Users/${username}/go
   export PATH=$PATH:$GOPATH/bin
   

3. Run the following command at root directory to generate Go code from .graphql file

   go-bindata -ignore=\.go -pkg=schema -o=schema/bindata.go schema/...
   

   OR

   go generate ./schema
   

   There would be bindata.go generated under schema folder

4. Start the server

   go build server.go
   

Graphql Example:

Test in graphiql by the following endpoint

localhost:3000

Basically there are two graphql queries and one mutation

Query:

1. Get a user by email
2. Get user list by cursor pagination

Mutation:

To query a list of users, you need to be authenticated. Authentication is not required for other operations. In order to authenticate, here are the steps to follow:

1. Create a user

mutation {
  createUser (email: "[email protected]", password: "123456") {
    id
  }
}

2. Log in by submitting your email and password through a Basic Authorization Header. Here's an example on how to achieve this: a. Download Insomnia b. Create a new POST request, paste localhost:3000/login in the URL bar and go to the Header tab c. Generate your basic Authorization on blitter.se d. In Insomnia, first column, type Authorization, second column enter the Basic you just copied Basic dGVzdGVyQHRlc3Rlci5jb206a3Rta3Rt e. Click send, you should get a jwt token back.

You can change the Authorization of request header in graphiql.html and restart the server to see the effect of authentication using token

Test:

• Run Unit Tests

  go test
  

Reference

-neelance/graphql-go

-tonyghita/graphql-go-example