Makefile

# Conveyor Makefile -

# Version constants
SWAG_VERSION := v1.16.6
# Default version for builds, can be overridden (e.g., make deb VERSION=1.0.0).
# The 'export' keyword makes it available to sub-processes like dpkg-buildpackage.
export VERSION ?= snapshot

# Ensure that targets which are not files are always executed.
.PHONY: help install-swag swagger-init start test docs deb

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

# --- Development Targets ---

start: ## Start the API server
	@echo "Starting API server..."
	go run main.go up

test: ## Run tests
	@echo "Running tests..."
	APP_ENV=test go test ./... -v

docs: ## Start documentation server
	@echo "Starting documentation server..."
	cd docs && npm run start

# --- Tooling & Documentation Generation ---

install-swag: ## Install swag CLI tool
	@echo "Installing swag CLI tool version $(SWAG_VERSION)..."
	go install github.com/swaggo/swag/cmd/swag@$(SWAG_VERSION)
	@echo "swag CLI tool installed"

swagger-init: ## Generate Swagger documentation
	@echo "Generating Swagger documentation..."
	swag init -g cmd/api/app.go -o internal/swagger
	@echo "Swagger documentation generated in internal/swagger/"

# --- Packaging Targets ---

deb: ## Build Debian package
	@echo "Building Debian package (VERSION=$(VERSION))..."
	@# Strip leading 'v' if present
	@VERSION_NO_V=$${VERSION#v}; \
	cp -R packaging/debian debian; \
	chmod 0755 debian/rules; \
	if [ -n "$$RELEASE_NOTES" ]; then \
		dch --newversion "$${VERSION_NO_V}-1" "Automated release from GitHub tag $${VERSION_NO_V}\n\n$$RELEASE_NOTES" --force-bad-version -D UNRELEASED; \
	else \
		dch --newversion "$${VERSION_NO_V}-1" "Automated release from GitHub tag $${VERSION_NO_V}" --force-bad-version -D UNRELEASED; \
	fi; \
	dpkg-buildpackage -us -uc -b; \
	echo "Debian package built."; \
	sudo rm -rf debian
	sudo rm conveyor