plumber-schemas

README

plumber-schemas

This repo contains protobuf schemas that are used by plumber and plumber-ui when communicating over gRPC.

IMPORTANT

The proto schemas are used to generate CLI flags in plumber. protos/cli.proto:CLIOptions is the entry point.

If you want to modify/add/remove cmds/args/flags, you will want to:

1. Clone this repo
2. Create a branch
3. Make changes to the schemas and include associated // @gotags: kong:"" comments
4. Run make generate/all
5. Copy the generated PB's into the plumber/vendor/github.com/batchcorp/plumber-schemas/... dir
6. Verify that plumber works with your new flags
7. If yes, create a PR for the plumber-schemas repo
8. Once the PR is merged, update plumber-schemas entry in plumber's go.mod to point to new release version
9. Run go mod vendor to ensure plumber fetches the appropriate plumber-schemas version

Making changes

1. git co -b username/change
2. make generate/all // this will run generate/go, generate/ts and run the struct tag injector
3. git add -a
4. git commit -a -m "updated schema XYZ
5. git push origin head
6. Open PR, review, merge

The build workflow will automatically create a tag for the last commit.

Documentation

Overview

Code generated via protoc creates private interfaces for oneoff's. Because there is no public interface, you must rely on verbose type switching if you need to do dynamically instantiate things.

This script is intended to be ran after protoc code generation. It will:

1. Search through all *.pb.go files for private interfaces that start with is*

2. If a private interface is found, it will write a "extra.pb.go" file in the pkg directory that will contain a _public_ type alias for the private interface.