vociferate/README.md

vociferate

A reusable release preparation tool for Go repositories.

Build

Build with just:

just go-build

Or directly with Go:

go build -o dist/releaseprep ./cmd/releaseprep

Usage

Prepare release files:

go run ./cmd/releaseprep --version v1.2.3 --date 2026-03-20 --root .

Recommend next release tag from changelog content:

go run ./cmd/releaseprep --recommend --root .

Flags

• --version semantic version to release (with or without leading v).
• --date release date in YYYY-MM-DD format.
• --recommend print recommended next tag based on ## [Unreleased].
• --root repository root directory.
• --version-file path to version source file relative to --root.
• --version-pattern regexp with exactly one capture group for version value.
• --changelog path to changelog file relative to --root.

Defaults:

• version-file: internal/releaseprep/version/version.go
• version-pattern: const String = "([^"]+)"
• changelog: changelog.md

Testing

just go-test