SHELL := /usr/bin/env bash GO ?= go GOFMT ?= gofmt INSTALL ?= install PREFIX ?= $(HOME)/.local BINDIR ?= $(PREFIX)/bin LIBDIR ?= $(PREFIX)/lib DESTDIR ?= BUILD_DIR ?= build BUILD_BIN_DIR ?= $(BUILD_DIR)/bin BUILD_MANUAL_DIR ?= $(BUILD_DIR)/manual BANGER_BIN ?= $(BUILD_BIN_DIR)/banger BANGERD_BIN ?= $(BUILD_BIN_DIR)/bangerd VSOCK_AGENT_BIN ?= $(BUILD_BIN_DIR)/banger-vsock-agent BINARIES := $(BANGER_BIN) $(BANGERD_BIN) $(VSOCK_AGENT_BIN) GO_SOURCES := $(shell find cmd internal -type f -name '*.go' | sort) # BUILD_INPUTS is everything that can change a binary's bytes: Go sources # plus embedded assets (catalog.json, future static files). Listing # everything is cheaper than missing a rebuild — go's own cache absorbs # any redundant invocations. BUILD_INPUTS := $(shell find cmd internal -type f | sort) SHELL_SOURCES := $(shell find scripts -type f -name '*.sh' | sort) VERSION ?= $(shell git describe --tags --exact-match 2>/dev/null || echo dev) COMMIT ?= $(shell git rev-parse --verify HEAD 2>/dev/null || echo unknown) BUILT_AT ?= $(shell date -u +%Y-%m-%dT%H:%M:%SZ) GO_LDFLAGS := -X banger/internal/buildinfo.Version=$(VERSION) -X banger/internal/buildinfo.Commit=$(COMMIT) -X banger/internal/buildinfo.BuiltAt=$(BUILT_AT) .DEFAULT_GOAL := help .PHONY: help build banger bangerd test fmt tidy clean install uninstall bench-create lint lint-go lint-shell coverage coverage-html coverage-total help: @printf '%s\n' \ 'Targets:' \ ' make build Build ./build/bin/banger, ./build/bin/bangerd, and ./build/bin/banger-vsock-agent' \ ' make install Build and install banger, bangerd, and the companion vsock helper' \ ' make uninstall Stop the daemon and remove installed binaries (leaves user state by default)' \ ' make test Run go test ./...' \ ' make coverage Run tests with coverage; print per-package + total' \ ' make coverage-html Open a browsable per-line HTML report (writes coverage.html)' \ ' make coverage-total Print just the total statement coverage (for scripts/CI)' \ ' make lint Run gofmt + go vet + shellcheck (errors)' \ ' make fmt Format Go sources under cmd/ and internal/' \ ' make tidy Run go mod tidy' \ ' make clean Remove built Go binaries and coverage artefacts' \ ' make bench-create Benchmark vm create and SSH readiness with scripts/bench-create.sh' build: $(BINARIES) $(BANGER_BIN): $(BUILD_INPUTS) go.mod go.sum mkdir -p "$(BUILD_BIN_DIR)" $(GO) build -ldflags '$(GO_LDFLAGS)' -o "$(BANGER_BIN)" ./cmd/banger $(BANGERD_BIN): $(BUILD_INPUTS) go.mod go.sum mkdir -p "$(BUILD_BIN_DIR)" $(GO) build -ldflags '$(GO_LDFLAGS)' -o "$(BANGERD_BIN)" ./cmd/bangerd $(VSOCK_AGENT_BIN): $(BUILD_INPUTS) go.mod go.sum mkdir -p "$(BUILD_BIN_DIR)" CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GO) build -ldflags '$(GO_LDFLAGS)' -o "$(VSOCK_AGENT_BIN)" ./cmd/banger-vsock-agent test: $(GO) test ./... # Coverage targets use -coverpkg=./... so packages without their own # tests still get counted when another package exercises them (common # for daemon/* subpackages). coverage.out is gitignored. coverage: $(GO) test -coverpkg=./... -coverprofile=coverage.out ./... @echo '' @echo 'Per-package:' @$(GO) tool cover -func=coverage.out | awk -F'\t+' '/^total:/ {total=$$NF; next} {pkg=$$1; sub("banger/", "", pkg); sub("/[^/]+:[0-9]+:$$", "", pkg); pkgs[pkg]+=1; covered[pkg]+=$$NF+0} END {for (p in pkgs) printf " %-40s %.1f%% (avg of %d funcs)\n", p, covered[p]/pkgs[p], pkgs[p] | "sort"; print ""; print "Total statement coverage:", total}' coverage-html: coverage $(GO) tool cover -html=coverage.out -o coverage.html @echo 'wrote coverage.html' coverage-total: @$(GO) test -coverpkg=./... -coverprofile=coverage.out ./... >/dev/null 2>&1 && $(GO) tool cover -func=coverage.out | awk '/^total:/ {print $$NF}' lint: lint-go lint-shell lint-go: @unformatted="$$($(GOFMT) -l $(GO_SOURCES))"; \ if [ -n "$$unformatted" ]; then \ printf 'gofmt: the following files are not formatted:\n%s\n' "$$unformatted" >&2; \ exit 1; \ fi $(GO) vet ./... lint-shell: @command -v shellcheck >/dev/null 2>&1 || { echo 'shellcheck is required for make lint-shell' >&2; exit 1; } shellcheck --severity=error $(SHELL_SOURCES) fmt: $(GOFMT) -w $(GO_SOURCES) tidy: $(GO) mod tidy clean: rm -rf "$(BUILD_BIN_DIR)" coverage.out coverage.html bench-create: build BANGER_BIN="$(abspath $(BANGER_BIN))" bash ./scripts/bench-create.sh $(ARGS) install: build mkdir -p "$(DESTDIR)$(BINDIR)" mkdir -p "$(DESTDIR)$(LIBDIR)/banger" $(INSTALL) -m 0755 "$(BANGER_BIN)" "$(DESTDIR)$(BINDIR)/banger" $(INSTALL) -m 0755 "$(BANGERD_BIN)" "$(DESTDIR)$(BINDIR)/bangerd" $(INSTALL) -m 0755 "$(VSOCK_AGENT_BIN)" "$(DESTDIR)$(LIBDIR)/banger/banger-vsock-agent" # uninstall stops a running daemon (if any) and removes the installed # binaries. It does NOT touch user data (config, SSH keys, VM state, # image/kernel caches) — rm -rf those paths manually if wanted; they # are printed for convenience. uninstall: @if [ -x "$(DESTDIR)$(BINDIR)/banger" ]; then \ "$(DESTDIR)$(BINDIR)/banger" daemon stop >/dev/null 2>&1 || true; \ fi rm -f "$(DESTDIR)$(BINDIR)/banger" "$(DESTDIR)$(BINDIR)/bangerd" rm -rf "$(DESTDIR)$(LIBDIR)/banger" @printf '\nRemoved binaries. User data is preserved at:\n' @printf ' ~/.config/banger/ (config, ssh keys)\n' @printf ' ~/.local/state/banger/ (VMs, images, kernels, db, logs)\n' @printf ' ~/.cache/banger/ (OCI layer cache)\n' @printf '\nDelete those paths manually if you want a full purge.\n'