protobuf-toolchain

A toolchain for working with Protocol Buffers in Go. It ships a family of buf-compatible binaries:

• labset-lint-plugin — a bufplugin check plugin for buf lint.
• protoc-gen-labset-go — a protoc codegen plugin for Go.

usage

• install with go install

go install github.com/labset/protobuf-toolchain/cmd/protoc-gen-labset-go@latest
go install github.com/labset/protobuf-toolchain/cmd/labset-lint-plugin@latest

• install with mise (via the go backend)

mise use "go:github.com/labset/protobuf-toolchain/cmd/protoc-gen-labset-go@latest"
mise use "go:github.com/labset/protobuf-toolchain/cmd/labset-lint-plugin@latest"

or pin them in a project's mise.toml:

[tools]
"go:github.com/labset/protobuf-toolchain/cmd/protoc-gen-labset-go" = "latest"
"go:github.com/labset/protobuf-toolchain/cmd/labset-lint-plugin" = "latest"

wiring the plugins into buf

• codegen with protoc-gen-labset-go:

# buf.gen.yaml
version: v2
plugins:
  - local: protoc-gen-labset-go
    out: gen
    opt: mode=<mode>

• linting with labset-lint-plugin:

# buf.yaml
version: v2
plugins:
  - plugin: labset-lint-plugin
lint:
  use:
    - STANDARD

resources

• contributing guide
• local testing guide