spec

Overview ¶

Command spec keeps the committed platform spec and the client generated from it in step with the platform. The CLI's requests and responses are compiled against that client, so a breaking change in the platform fails the build instead of a customer's pipeline.

go run ./internal/tools/spec fetch              download the live spec into openapi/platform-api.json
go generate ./api                               regenerate api/platform.gen.go from the committed spec
go run ./internal/tools/spec coverage [spec]    list the operations no command calls (a file or URL;
                                                the committed spec by default)