SHELL := bash

.DELETE_ON_ERROR:

.SHELLFLAGS := -eu -o pipefail -c

.DEFAULT_GOAL := all

MAKEFLAGS += --warn-undefined-variables

MAKEFLAGS += --no-builtin-rules

MAKEFLAGS += --no-print-directory

BIN := .tmp/bin

COPYRIGHT_YEARS := 2023-2025

LICENSE_IGNORE := -e internal/testdata/

GO ?= go

BUF_VERSION ?= v1.50.0

GOLANGCI_LINT_VERSION ?= v2.12.2

.PHONY: help

help: ## Describe useful make targets

@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "%-30s %s\n", $$1, $$2}'

.PHONY: all

all: ## Build, test, and lint (default)

$(MAKE) test

$(MAKE) lint

.PHONY: clean

clean: ## Delete intermediate build artifacts

@# -X only removes untracked files, -d recurses into directories, -f actually removes files/dirs

git clean -Xdf

.PHONY: test

test: build ## Run unit tests

$(GO) test -vet=off -race -cover ./...

.PHONY: build

build: generate ## Build all packages

$(GO) build ./...

.PHONY: install

install: ## Install all binaries

$(GO) install ./...

.PHONY: lint

lint: $(BIN)/golangci-lint ## Lint Go and protobuf

$(GO) vet ./...

$(BIN)/golangci-lint run

.PHONY: lintfix

lintfix: $(BIN)/golangci-lint ## Automatically fix some lint errors

$(BIN)/golangci-lint run --fix

.PHONY: generate

generate: $(BIN)/buf $(BIN)/license-header ## Regenerate code and licenses

rm -rf internal/testdata/gen internal/proto/gen

PATH=$(abspath $(BIN)) cd internal/testdata && buf generate && cd ../proto && buf generate

@# We want to operate on a list of modified and new files, excluding

@# deleted and ignored files. git-ls-files can't do this alone. comm -23 takes

@# two files and prints the union, dropping lines common to both (-3) and

@# those only in the second file (-2). We make one git-ls-files call for

@# the modified, cached, and new (--others) files, and a second for the

@# deleted files.

comm -23 \

<(git ls-files --cached --modified --others --no-empty-directory --exclude-standard | sort -u | grep -v $(LICENSE_IGNORE) ) \

<(git ls-files --deleted | sort -u) | \

xargs $(BIN)/license-header \

--license-type apache \

--copyright-holder "Buf Technologies, Inc." \

--year-range "$(COPYRIGHT_YEARS)"

.PHONY: upgrade

upgrade: ## Upgrade dependencies

go get -u -t ./... && go mod tidy -v

.PHONY: checkgenerate

checkgenerate:

@# Used in CI to verify that `make generate` doesn't produce a diff.

test -z "$$(git status --porcelain | tee /dev/stderr)"

$(BIN)/buf: Makefile

@mkdir -p $(@D)

GOBIN=$(abspath $(@D)) $(GO) install github.com/bufbuild/buf/cmd/buf@$(BUF_VERSION)

$(BIN)/license-header: Makefile

@mkdir -p $(@D)

GOBIN=$(abspath $(@D)) $(GO) install \

github.com/bufbuild/buf/private/pkg/licenseheader/cmd/license-header@$(BUF_VERSION)

$(BIN)/golangci-lint: Makefile

@mkdir -p $(@D)

GOBIN=$(abspath $(@D)) $(GO) install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@$(GOLANGCI_LINT_VERSION)