speakeasy-api / cli
Track the state of your API and orchestrate your API lifecycle from code to artifacts to infra. Manage your APIs with ease !
README
Speakeasy CLI
This is a shell repo that houses the CLI used for interacting with Speakeasy's orchestration capabilities for the API lifecycle. Under the hood it calls lanaguage specific code parsing libraries.
Brew Tap
This CLI is available using brew:
brew install speakeasy-api/taps/speakeasy
Creating a release
We use goreleaser to manage the versioned releases of the CLI. To release a new version:
- Ensure you have the right version of
speakeasy-corelibraries pinned in dependencies - Create a new tag of the CLI with
git tag vX.X.Xandgit push origin tag vX.X.X. Add any useful descriptions or associated GH tickets that have been closed in the description - Assuming you have
goreleaserinstalled rungoreleaser release. This will take the latest tag of the cli and update our homebrew tap to point to the latest version as well as upload built binaries for different architectures - (optional) If you want to sandbox the above step you may run
goreleaser release --snapshot --rm-distlocally to check the build. If you want to check syntax in thegoreleaserconfig file rungoreleaser check.
Documentation
Usage documentation for the CLI powered through the parser repo and hosted at docs.speakeasyapi.dev
