go-protoc-gen-connect-query is a distribution of protoc-gen-connect-query that can be built with Go.
It does not actually reimplement any functionality of connect-query in Go, instead packaging it with the
lightweight JS runtime QuickJS, and executing with the pure Go Wasm runtime wazero.
This means that go install
or go run
can be used to execute it, with no need to rely on external
package managers such as NPM, on any platform that Go supports.
Precompiled binaries are available in the releases.
Alternatively, install the plugin using go install
.
$ go install github.com/wasilibs/go-protoc-gen-connect-query/cmd/protoc-gen-connect-query@latest
As long as $GOPATH/bin
, e.g. ~/go/bin
is on the PATH
, you can use it with protoc as normal.
$ protoc --es_out=out/es -Iprotos protos/helloworld.proto
For buf users, to avoid installation entirely, it can be convenient to use go run
in buf.gen.yaml
.
version: v1
plugins:
- plugin: connect-query
out: out/es
path:
- "go"
- "run"
- "github.com/wasilibs/go-protoc-gen-connect-query/cmd/protoc-gen-connect-query@latest"
This makes it possible to have full protobuf/gRPC generation with no installation of tools,
besides Go itself, on any platform that Go supports. The above examples use @latest
, but it is
recommended to specify a version, in which case all of the developers on your codebase will use the
same version of the tool with no special steps.
See a full example in go-protoc-gen-builtins
. To generate protos, enter the directory and run
go run github.com/bufbuild/buf/cmd/[email protected] generate
. As long as your machine has Go installed,
you will be able to generate protos. The first time using go run
for a command, Go automatically builds
it making it slower, but subsequent invocations should be quite fast.