Protoc plugins for generating graphql schema and go graphql code
If you use micro-service architecture with grpc for back-end and graphql api gateway for front-end, you will find yourself repeating a lot of code for translating from one transport layer to another (which many times may be a source of bugs)
This repository aims to simplify working with grpc trough protocol buffers and graphql by generating code.
go install github.com/danielvladco/go-proto-gql/protoc-gen-gql go install github.com/danielvladco/go-proto-gql/protoc-gen-gogql
The protoc compiler expects to find plugins named
proto-gen-<PLUGIN_NAME> on the execution
$PATH. So first:
--gql_out plugin will generate graphql files with extension
rather than go code which means it can be further used for any other language or framework.
protoc --gql_out=paths=source_relative:. -I=. -I=./example/ ./example/*.proto
If you still want to generate go source code instead of graphql then use
https://awesomeopensource.com/project/99designs/gqlgen plugin, and map all the generated go types with all the generated graphql types.
--gqlgencfg_out plugin does exactly this.
--gogql_out plugin generates methods for implementing
github.com/99designs/gqlgen/graphql.Unmarshaler interfaces. Now proto
maps will work fine with graphql.
This plugin also creates convenience methods that will implement generated by the
protoc --gogql_out=gogoimport=false,paths=source_relative:. -I=. -I=./example/ ./example/*.proto
/example folder for more examples.
A unified gateway is also possible. Right now a gateway can be spawn up
pointing to a list of grpc endpoints (grpc reflection must be enabled on the grpc servers).
The gateway will query the servers for protobuf descriptors and generate a graphql schema abstract tree.
The requests to the gateway will be transformed on the fly to grpc servers without any additional code generation
or writing any code at all. See
examples/gateway for usage more info.
Will be very glad for any contributions so feel free to create issues, forks and PRs.
go-proto-gql is released under the Apache 2.0 license. See the LICENSE file for details.