Trust

Release

GitHubEdit page

Release

Releases are tag-driven. The release workflow builds GitHub Release archives with GoReleaser, then dispatches the Homebrew tap updater when the tap token is configured.

#Cut a Release

git tag -a vX.Y.Z -m "Release X.Y.Z"
git push origin main vX.Y.Z

To re-run a release for an existing tag, start the release workflow manually and pass tag: vX.Y.Z.

#Release Artifacts

Expected archive names:

  • gobankcli_<version>_darwin_amd64.tar.gz
  • gobankcli_<version>_darwin_arm64.tar.gz
  • gobankcli_<version>_linux_amd64.tar.gz
  • gobankcli_<version>_linux_arm64.tar.gz
  • checksums.txt

GoReleaser stamps the binary with:

  • main.version={{ .Version }}

The stamped binary should print the release version:

gobankcli --version

#Homebrew Tap

The release workflow dispatches update-formula.yml in BramVR/homebrew-tap. That tap workflow owns the formula-editing logic and updates the target-specific archive URLs and SHA256 values in Formula/gobankcli.rb.

Repository secret:

  • HOMEBREW_TAP_TOKEN: token allowed to run workflows in BramVR/homebrew-tap

If the secret is missing, GitHub Release artifacts are still published and the tap update is skipped with a warning.

#Verify

gh release view vX.Y.Z --repo BramVR/goBankCli
gh release download vX.Y.Z --repo BramVR/goBankCli --pattern "checksums.txt"
brew update
brew install BramVR/tap/gobankcli
gobankcli --version
brew test BramVR/tap/gobankcli

Check that the GitHub Release contains the changelog or release notes for the version before closing the release.