Makefile

# Prepend docker command with sudo if necessary.
SUDO := $(shell docker version >/dev/null 2>&1 || echo "sudo")

# Extract short commit hash from the current checked-out branch.
LABEL ?= $(shell git rev-parse --short HEAD)$(and $(shell git status -s),-dirty-$(shell id -u -n))

# When building the application for deployment, set the TAG parameter according to your organization's DockerHub repository.
TAG ?= stellar/wallet-backend:$(LABEL)

# https://github.com/opencontainers/image-spec/blob/master/annotations.md
BUILD_DATE ?= $(shell date -u +%FT%TZ)

# Version of Stellar Core to be installed. Choose from jammy builds at https://apt.stellar.org/pool/stable/s/stellar-core/
STELLAR_CORE_VERSION ?= 21.0.0-1872.c6f474133.jammy

# ==================================================================================== #
# QUALITY & PREPARATION
# ==================================================================================== #
tidy: ## Tidy modfiles and format source files
	@echo "==> Tidying module files..."
	go mod tidy -v
	@echo "==> Formatting code..."
	go fmt ./...
	@command -v $(shell go env GOPATH)/bin/gofumpt >/dev/null 2>&1 || { go install mvdan.cc/gofumpt@v0.9.2; }
	$(shell go env GOPATH)/bin/gofumpt -l -w .
	@echo "==> Fixing imports..."
	@command -v $(shell go env GOPATH)/bin/goimports >/dev/null 2>&1 || { go install golang.org/x/tools/cmd/goimports@v0.43.0; }
	@find . -type f -name "*.go" ! -path "*mock*" | xargs $(shell go env GOPATH)/bin/goimports -local "github.com/stellar/wallet-backend" -w

fmt: ## Check if code is formatted with gofmt
	@echo "==> Checking formatting..."
	@test -z $(shell gofmt -l .) || (echo "ERROR: Unformatted files found. Run 'make tidy' or 'gofmt -w .'"; exit 1)
	@echo "Format check passed."

vet: ## Run go vet checks
	@echo "==> Running go vet..."
	go vet ./...

lint: ## Run golangci-lint linter (requires: brew install golangci-lint or equivalent)
	@echo "==> Running golangci-lint..."
	@command -v golangci-lint >/dev/null 2>&1 || { echo >&2 "ERROR: golangci-lint not found. Install it: https://golangci-lint.run/usage/install/"; exit 1; }
	golangci-lint run ./...

shadow: ## Run shadow analysis to find shadowed variables
	@echo "==> Running shadow analyzer..."
	@if ! command -v $(shell go env GOPATH)/bin/shadow >/dev/null 2>&1; then \
		echo "Installing shadow..."; \
		go install golang.org/x/tools/go/analysis/passes/shadow/cmd/shadow@v0.43.0; \
	fi
	@$(shell go env GOPATH)/bin/shadow ./... | { grep -v "generated.go" || true; }

deadcode: ## Find unused code
	@echo "==> Checking for deadcode..."
	@if ! command -v $(shell go env GOPATH)/bin/deadcode >/dev/null 2>&1; then \
		echo "Installing deadcode..."; \
		go install golang.org/x/tools/cmd/deadcode@v0.43.0; \
	fi
	@output=$$($(shell go env GOPATH)/bin/deadcode -test ./... | grep -v "UnmarshalUInt32" | grep -v "isBalance"); \
	if [ -n "$$output" ]; then \
		echo "🚨 Deadcode found:"; \
		echo "$$output"; \
		exit 1; \
	else \
		echo "✅ No deadcode found"; \
	fi

fix-imports: ## Fix import formatting and organization
	@echo "==> Fixing imports..."
	@command -v $(shell go env GOPATH)/bin/goimports >/dev/null 2>&1 || { go install golang.org/x/tools/cmd/goimports@v0.43.0; }
	@find . -type f -name "*.go" ! -path "*mock*" | xargs $(shell go env GOPATH)/bin/goimports -local "github.com/stellar/wallet-backend" -w
	@echo "✅ Imports fixed."

goimports: ## Check import formatting and organization
	@echo "==> Checking imports..."
	@command -v $(shell go env GOPATH)/bin/goimports >/dev/null 2>&1 || { go install golang.org/x/tools/cmd/goimports@v0.43.0; }
	@non_compliant_files=$$(find . -type f -name "*.go" ! -path "*mock*" | xargs $(shell go env GOPATH)/bin/goimports -local "github.com/stellar/wallet-backend" -l); \
	if [ -n "$$non_compliant_files" ]; then \
		echo "🚨 The following files are not compliant with goimports:"; \
		echo "$$non_compliant_files"; \
		exit 1; \
	else \
		echo "✅ All files are compliant with goimports."; \
	fi

check: gql-validate tidy fmt vet lint shadow deadcode fix-imports ## Run all checks
	@echo "✅ All checks completed successfully"

# ==================================================================================== #
# GRAPHQL
# ==================================================================================== #
gql-generate: ## Generate GraphQL code using gqlgen
	@echo "==> Generating GraphQL code..."
	@command -v $(shell go env GOPATH)/bin/gqlgen >/dev/null 2>&1 || { go install github.com/99designs/gqlgen@v0.17.88; }
	$(shell go env GOPATH)/bin/gqlgen generate
	@echo "==> Normalizing imports on generated code..."
	@command -v $(shell go env GOPATH)/bin/goimports >/dev/null 2>&1 || { go install golang.org/x/tools/cmd/goimports@v0.43.0; }
	@find . -type f -name "*.go" ! -path "*mock*" | xargs $(shell go env GOPATH)/bin/goimports -local "github.com/stellar/wallet-backend" -w
	@echo "✅ GraphQL code generated successfully"

gql-validate: ## Validate GraphQL schema
	@echo "==> Validating GraphQL schema..."
	@command -v $(shell go env GOPATH)/bin/gqlgen >/dev/null 2>&1 || { go install github.com/99designs/gqlgen@v0.17.88; }
	$(shell go env GOPATH)/bin/gqlgen validate
	@echo "✅ GraphQL schema is valid"

# ==================================================================================== #
# TESTING
# ==================================================================================== #
unit-test: ## Run unit tests
	@echo "==> Running unit tests..."
	ENABLE_INTEGRATION_TESTS=false go test -v -race ./...

build-integration-image: ## Build integration test Docker image with git commit tag
	@echo "==> Building integration test image..."
	@GIT_COMMIT=$$(git rev-parse --short HEAD 2>/dev/null || echo "latest"); \
	IMAGE_TAG="wallet-backend:integration-test-$$GIT_COMMIT"; \
	$(SUDO) docker build \
		--file Dockerfile \
		--tag "$$IMAGE_TAG" \
		--build-arg GIT_COMMIT="$$GIT_COMMIT" \
		.; \
	echo "✅ Built image: $$IMAGE_TAG"

rebuild-integration-image: ## Force rebuild integration test Docker image
	@echo "==> Force rebuilding integration test image..."
	@GIT_COMMIT=$$(git rev-parse --short HEAD 2>/dev/null || echo "latest"); \
	IMAGE_TAG="wallet-backend:integration-test-$$GIT_COMMIT"; \
	$(SUDO) docker build \
		--file Dockerfile \
		--no-cache \
		--tag "$$IMAGE_TAG" \
		--build-arg GIT_COMMIT="$$GIT_COMMIT" \
		.; \
	echo "✅ Force rebuilt image: $$IMAGE_TAG"

integration-test: ## Run integration tests (auto-detects if rebuild needed)
	@echo "==> Running integration tests..."
	ENABLE_INTEGRATION_TESTS=true go test -v ./internal/integrationtests/... -timeout 30m

integration-test-clean: ## Force rebuild integration test image and run tests
	@echo "==> Force rebuilding and running integration tests..."
	FORCE_REBUILD=true ENABLE_INTEGRATION_TESTS=true go test -v ./internal/integrationtests/... -timeout 30m

docker-build:
	$(SUDO) docker build \
		--file Dockerfile \
		--pull \
		--label org.opencontainers.image.created="$(BUILD_DATE)" \
		--tag $(TAG) \
		--build-arg GIT_COMMIT=$(LABEL) \
		--build-arg STELLAR_CORE_VERSION=$(STELLAR_CORE_VERSION) \
		--platform linux/amd64 \
		.

docker-push:
	$(SUDO) docker push $(TAG)

go-install:
	go install -ldflags "-X main.GitCommit=$(LABEL)" .