Skip to content

A tool to merge & stitch the modularized GraphQL schema files into one schema

License

Notifications You must be signed in to change notification settings

mununki/gqlmerge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gqlmerge

A tool to merge and stitch modularized GraphQL files into one schema file

Demo

Demo

Stack

  • Built in Go
  • No 3rd party dependency

Features

  • Fast, blasing fast
  • Find *.graphql and *.gql files in recursive way
  • Merge and stitch schema from several directories
  • CLI to use in shell or script

How to use

Install to use in CLI

Homebrew

$ brew install mununki/tools/gqlmerge

Using go get

$ go get -u github.com/mununki/gqlmerge

Building with source code

$ git clone https://github.com/mununki/gqlmerge

$ cd gqlmerge

$ go install

Use as a go module

Import gqlmerge module

import gql "github.com/mununki/gqlmerge/lib"

func main(){
	// ...

	// "  " is indent for the padding in generating schema
	// in case of using as go module, just " " would be fine
	//
	// paths should be a relative path
	schema := gql.Merge(" ", path1, path2, ...)
}

What for?

If you have a modularized GraphQL schema files, such as *.graphql, there might be a duplicated types among them. In this case, gqlmerge will help you to merge and stitch it into one schema.

Before

# GetMyProfile.graphql

type Query {
  getMyProfile: UserResponse!
}

type UserResponse {
  ok: Boolean!
  error: String
  user: User
}

type User {
  id: ID!
  email: String!
  fullName: String!
  # ...
}

# CheckIfExists.graphql

type Query {
  checkIfExists(userId: ID!): CheckIfExistsResponse!
}

type CheckIfExistsResponse {
  ok: Boolean!
  error: String
  user: [User]!
}

type User {
  id: ID!
  email: String!
  fullName: String!
  # ...
}

Merge & Stitch

$ gqlmerge ./schema schema.graphql

After

type Query {
  getMyProfile: UserResponse!
  checkIfExists(userId: ID!): CheckIfExistsResponse!
}

type UserResponse {
  ok: Boolean!
  error: String
  user: User
}

type CheckIfExistsResponse {
  ok: Boolean!
  error: String
  user: [User]!
}

type User {
  id: ID!
  email: String!
  fullName: String!
  # ...
}

How to use

$ gqlmerge --indent=2s [PATH ...] [OUTPUT]

// PATH : directories with schema
// OUTPUT : output file name

Next to do

  • additional error handling

About

A tool to merge & stitch the modularized GraphQL schema files into one schema

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •