feat(version): add --raw to print the version alone - #1679

What

Add a --raw flag to git-bug version, which currently prints:

git-bug v1.2.3 8a3f1b2c9d0e go1.21.0 linux amd64

--raw prints just the version, on a line of its own:

v1.2.3

This is #1528, in the shape git-annex version --raw established: one bare version string that can be embedded in a statusline, a package script, or a version comparison without the caller having to strip a prefix and every metadata field.

Closes #1528.

Why this shape

The raw value is cut from the same string the default output prints (strings.Cut(full, " ")), rather than read from a second place. <version> is documented as the first space-separated field, so the two forms cannot drift apart, and there is no new code path deciding what the version "really" is.

--raw also emits a trailing newline, unlike the current output which ends without one. That is what makes $(git-bug version --raw) behave, and it is the only difference the flag introduces beyond the field itself.

The default output is byte-for-byte unchanged — TestVersionCommandDefaultUnchanged asserts that against the full documented string, so the flag cannot regress anything that parses the existing form.

Tests

commands/version_test.go, new:

• TestRawVersion — table over the shapes getVersion() can produce: bare version, version + commit, commit/dirty, the undefined (no build info) fallback, the full documented shape, and the empty string. It pins the first-field rule rather than a single example.
• TestVersionCommandRaw — runs the command and asserts the exact stdout, v1.2.3\n.
• TestVersionCommandDefaultUnchanged — runs the command without the flag and asserts the pre-existing output.

$ go test ./commands/...      ok
$ go vet ./commands/          clean
$ gofmt -l commands/          clean

Built and run locally:

$ go run . version
git-bug undefined go1.26.0 linux amd64
$ go run . version --raw
undefined

Generated files

doc/md/git-bug_version.md and doc/man/git-bug-version.1 are regenerated with go generate, which the CI job Check generated files are up to date verifies. Shell completions are unchanged (cobra emits flag names dynamically).

I did not include the api/graphql/graph/repository.generated.go drift that go generate ./... also produced; it is unrelated to this change and is a separate question.

Notes

• No behavior change without the flag; this is additive.
• I left the /dirty and commit-hash discussion in feat: add --raw to version #1528 alone — those fields are already in the default output and --raw simply omits them, which is the point of the flag.

Confidence Score: 5/5

_{Reviews (2) · Last reviewed commit: "docs(version): avoid angle brackets in t..." · Reviewed by Greptile}