Skip to content

Quick start leads with the checksummed release binary, without Go or sudo, and a release's Homebrew formula renders from its checksums.txt - #44

Merged
thebenignhacker merged 1 commit into
mainfrom
integrate/2026-10-20-r1
Oct 20, 2026
Merged

thebenignhacker merged 1 commit into
mainfrom
integrate/2026-10-20-r1

Conversation

@thebenignhacker

Copy link
Copy Markdown
Member

This pull request lands 1 commit in README.md, docs/install.md, CONTRIBUTING.md, CHANGELOG.md, cmd/tlsanalyzer and packaging/brewformula.

Included

  • Quick start leads with the checksummed release binary, without Go or sudo, and a release's Homebrew formula renders from its checksums.txt

Verified on this exact tree

  • go build ./...: exit 0
  • go vet ./...: exit 0
  • gofmt -s -l .: 0 files listed
  • go mod verify: all modules verified
  • git ls-files --others -- '*_test.go': 0 untracked test files; git ls-files -- '*_test.go' | wc -l: 105
  • golangci-lint run --timeout=5m ./... (golangci-lint 2.12.2, empty cache): 0 issues
  • go test -v -race -p 4 -count=1 ./...: 7 packages ok, 0 FAIL; 433 tests passed, 0 failed, 1 skipped (TestFIPSChildScanNamesTheHybridGroupsItCannotOffer, skip message "runs in the child process that TestAFIPSBuildWithoutMLKEMNamesTheHybridGroupsItCannotOffer starts"); 543 subtests passed, 0 failed, 0 skipped
  • Changelog check: the repository has no changelog check script

Not included

None

Closes

None

How to merge

Rebase and merge, so that each change stays its own commit on main.

…sudo, and a release's Homebrew formula renders from its checksums.txt

The README's quick start opened with git clone, go build and sudo mv, so
a first scan needed Go 1.25+ and sudo, while each release from 0.4.0
publishes checksummed archives. Its first block now downloads the latest
release's archive for macOS on Apple silicon and checksums.txt with
curl, unpacks the archive only after shasum reports it OK, and runs
./tlsanalyzer version. Run as written with no Go on PATH, the block
printed "tlsanalyzer-darwin-arm64.tar.gz: OK" and version 0.4.1, and
./tlsanalyzer qramm.org then printed "TLS Security: B (76/100)" and
exited 0. With a corrupted archive the check printed FAILED and tar did
not run. Building from source comes second and runs the binary where it
was built. docs/install.md names the archive for each platform, and a
test keeps the quick start's first block a release download with no
sudo in any quick start command.

packaging/brewformula prints the Homebrew formula for a release from
that release's checksums.txt, so each sha256 line is the published
digest of the archive on the url line above it. It refuses a version
that is not X.Y.Z, a line that is not a digest and a file name, an
archive given two digests, and a checksums.txt without one of the four
macOS and Linux archives. A test ties its archive names, and the
tlsanalyzer binary at the top of each archive, to the release workflow.

Rendered for v0.4.1, each of the four url lines downloaded an archive
whose sha256 matched the line after it and whose only member is
tlsanalyzer. Homebrew's formula loader, simulating macOS and Linux on
arm and intel, resolved each to its own archive and digest at version
0.4.1. CONTRIBUTING.md adds rendering the formula to the release
process; the formula is not yet in csnp/homebrew-tap.
@thebenignhacker
thebenignhacker merged commit c73c70f into main Oct 20, 2026
2 checks passed
@thebenignhacker
thebenignhacker deleted the integrate/2026-10-20-r1 branch October 20, 2026 22:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant