Makefile

# Go-Graphql Makefile
# Build, test, and development automation

# ============================================================================
# Variables
# ============================================================================

# Go parameters
GOCMD := go
GOBUILD := $(GOCMD) build
GOTEST := $(GOCMD) test
GOVET := $(GOCMD) vet
GOFMT := gofmt
GOMOD := $(GOCMD) mod
GOGENERATE := $(GOCMD) generate

# Binary
BINARY_NAME := go-graphql
BINARY_DIR := bin

# Coverage
COVERAGE_FILE := coverage.out
COVERAGE_HTML := coverage.html
COVERAGE_TARGET := 80

# Packages
PACKAGES := ./...
PACKAGES_NO_MOCKS := $(shell go list ./... | grep -v /mocks)

# Tools
GOLANGCI_LINT := golangci-lint
GINKGO := ginkgo

# ============================================================================
# Default target
# ============================================================================

.PHONY: all
all: fmt vet lint test build

# ============================================================================
# Build targets
# ============================================================================

.PHONY: build
build: ## Build the binary
	@echo "Building $(BINARY_NAME)..."
	@mkdir -p $(BINARY_DIR)
	$(GOBUILD) -o $(BINARY_DIR)/$(BINARY_NAME) ./cmd

.PHONY: clean
clean: ## Clean build artifacts
	@echo "Cleaning..."
	@rm -rf $(BINARY_DIR)
	@rm -f $(COVERAGE_FILE) $(COVERAGE_HTML)

# ============================================================================
# Code quality targets
# ============================================================================

.PHONY: fmt
fmt: ## Format code with gofmt
	@echo "Formatting code..."
	@$(GOFMT) -s -w .

.PHONY: fmt-check
fmt-check: ## Check if code is formatted
	@echo "Checking code format..."
	@test -z "$$($(GOFMT) -s -l . | tee /dev/stderr)" || (echo "Code is not formatted. Run 'make fmt'" && exit 1)

.PHONY: vet
vet: ## Run go vet
	@echo "Running go vet..."
	$(GOVET) $(PACKAGES)

.PHONY: lint
lint: ## Run golangci-lint
	@echo "Running linter..."
	@which $(GOLANGCI_LINT) > /dev/null || (echo "golangci-lint not found. Install: https://golangci-lint.run/usage/install/" && exit 1)
	$(GOLANGCI_LINT) run $(PACKAGES)

# ============================================================================
# Test targets
# ============================================================================

.PHONY: test
test: ## Run all tests
	@echo "Running tests..."
	$(GOTEST) -v -race $(PACKAGES_NO_MOCKS)

.PHONY: test-short
test-short: ## Run tests without race detector (faster)
	@echo "Running tests (short mode)..."
	$(GOTEST) -v $(PACKAGES_NO_MOCKS)

.PHONY: test-coverage
test-coverage: ## Run tests with coverage report
	@echo "Running tests with coverage..."
	$(GOTEST) -v -race -coverprofile=$(COVERAGE_FILE) -covermode=atomic $(PACKAGES_NO_MOCKS)
	@echo ""
	@echo "Coverage summary:"
	@$(GOCMD) tool cover -func=$(COVERAGE_FILE) | tail -1
	@echo ""
	@echo "Generating HTML report: $(COVERAGE_HTML)"
	@$(GOCMD) tool cover -html=$(COVERAGE_FILE) -o $(COVERAGE_HTML)
	@echo ""
	@echo "Per-package coverage:"
	@$(GOCMD) tool cover -func=$(COVERAGE_FILE) | grep -E "^[a-z]" | grep -v "total:" || true

.PHONY: test-coverage-view
test-coverage-view: test-coverage ## Run tests with coverage and open HTML report
	@echo "Opening coverage report..."
	@xdg-open $(COVERAGE_HTML) 2>/dev/null || open $(COVERAGE_HTML) 2>/dev/null || echo "Open $(COVERAGE_HTML) in your browser"

.PHONY: test-ginkgo
test-ginkgo: ## Run tests with Ginkgo (if installed)
	@echo "Running tests with Ginkgo..."
	@which $(GINKGO) > /dev/null || (echo "Ginkgo not found. Install: go install github.com/onsi/ginkgo/v2/ginkgo@latest" && exit 1)
	$(GINKGO) -v -race -cover -coverprofile=$(COVERAGE_FILE) $(PACKAGES_NO_MOCKS)

# ============================================================================
# Generation targets
# ============================================================================

.PHONY: generate
generate: ## Generate mocks and other code
	@echo "Generating code..."
	$(GOGENERATE) ./tools/...

.PHONY: generate-check
generate-check: generate ## Check if generated code is up to date
	@echo "Checking if generated code is up to date..."
	@git diff --exit-code || (echo "Generated code is out of date. Run 'make generate' and commit changes." && exit 1)

# ============================================================================
# Dependency targets
# ============================================================================

.PHONY: deps
deps: ## Download dependencies
	@echo "Downloading dependencies..."
	$(GOMOD) download

.PHONY: tidy
tidy: ## Tidy go.mod
	@echo "Tidying go.mod..."
	$(GOMOD) tidy

.PHONY: verify
verify: ## Verify dependencies
	@echo "Verifying dependencies..."
	$(GOMOD) verify

# ============================================================================
# CI targets
# ============================================================================

.PHONY: ci
ci: fmt-check vet lint test ## Run all CI checks
	@echo "CI checks passed!"

.PHONY: ci-coverage
ci-coverage: fmt-check vet lint test-coverage ## Run all CI checks with coverage
	@echo "CI checks with coverage passed!"

# ============================================================================
# Development targets
# ============================================================================

.PHONY: run
run: build ## Build and run the application
	@echo "Running $(BINARY_NAME)..."
	./$(BINARY_DIR)/$(BINARY_NAME)

.PHONY: install-tools
install-tools: ## Install development tools
	@echo "Installing development tools..."
	go install github.com/onsi/ginkgo/v2/ginkgo@latest
	@echo "Note: Install golangci-lint from https://golangci-lint.run/usage/install/"

# ============================================================================
# Container image targets
# ============================================================================

# Image configuration
IMG_TAG ?= dev
VERSION ?= 0.1.0
BUILD_TIME ?= $(shell date -u +"%Y-%m-%dT%H:%M:%SZ")

# Kind cluster configuration
KIND_CLUSTER_NAME ?= kind
KIND_IMAGE ?= kindest/node:v1.31.0

.PHONY: docker-build
docker-build: ## Build container image with ko (local)
	@echo "Building container image with ko..."
	VERSION=$(VERSION) BUILD_TIME=$(BUILD_TIME) ko build ./cmd --local --bare -t $(IMG_TAG)

.PHONY: docker-push
docker-push: ## Build and push container image with ko
	@echo "Building and pushing container image..."
	VERSION=$(VERSION) BUILD_TIME=$(BUILD_TIME) ko build ./cmd --bare -t $(IMG_TAG)

# ============================================================================
# Help
# ============================================================================

.PHONY: help
help: ## Show this help message
	@echo "Go Graphql Makefile"
	@echo ""
	@echo "Usage: make [target]"
	@echo ""
	@echo "Targets:"
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'