banger/Makefile

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 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'

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

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'