Fancy Makefile

Author: tschm

Makefile

@@ -1,41 +1,56 @@
+# Colors for pretty output
+BLUE := \033[36m
+BOLD := \033[1m
+RESET := \033[0m
+
 .DEFAULT_GOAL := help
 
+.PHONY: help verify install fmt test marimo clean
+
+##@ Development Setup
+
 venv:
+	@printf "$(BLUE)Creating virtual environment...$(RESET)\n"
 	@curl -LsSf https://astral.sh/uv/install.sh | sh
-	@uv venv --python='3.12'
+	@uv venv --python 3.12
 
+install: venv ## Install all dependencies using uv
+	@printf "$(BLUE)Installing dependencies...$(RESET)\n"
+	@uv sync --dev --frozen
 
-.PHONY: install
-install: venv ## Install a virtual environment
-	@uv pip install --upgrade pip
-	@uv sync --all-extras --dev --frozen
+##@ Code Quality
 
-
-.PHONY: fmt
-fmt: venv ## Run autoformatting and linting
+fmt: venv ## Run code formatting and linting
+	@printf "$(BLUE)Running formatters and linters...$(RESET)\n"
 	@uv pip install pre-commit
 	@uv run pre-commit install
 	@uv run pre-commit run --all-files
 
+##@ Testing
 
-.PHONY: clean
-clean:  ## Clean up caches and build artifacts
-	@git clean -X -d -f
+test: install ## Run all tests
+	@printf "$(BLUE)Running tests...$(RESET)\n"
+	@uv pip install pytest
+	@uv run pytest src/tests
 
+##@ Cleanup
 
-.PHONY: help
-help:  ## Display this help screen
-	@echo -e "\033[1mAvailable commands:\033[0m"
-	@grep -E '^[a-z.A-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-18s\033[0m %s\n", $$1, $$2}' | sort
+clean: ## Clean generated files and directories
+	@printf "$(BLUE)Cleaning project...$(RESET)\n"
+	@git clean -d -X -f
 
+##@ Marimo & Jupyter
 
-.PHONY: marimo
-marimo: install ## Install Marimo
+marimo: install ## Start a Marimo server
+	@printf "$(BLUE)Start Marimo server...$(RESET)\n"
 	@uv pip install marimo
 	@uv run marimo edit book/marimo
 
+##@ Help
+
+help: ## Display this help message
+	@printf "$(BOLD)Usage:$(RESET)\n"
+	@printf "  make $(BLUE)<target>$(RESET)\n\n"
+	@printf "$(BOLD)Targets:$(RESET)\n"
+	@awk 'BEGIN {FS = ":.*##"; printf ""} /^[a-zA-Z_-]+:.*?##/ { printf "  $(BLUE)%-15s$(RESET) %s\n", $$1, $$2 } /^##@/ { printf "\n$(BOLD)%s$(RESET)\n", substr($$0, 5) }' $(MAKEFILE_LIST)
 
-.PHONY: test
-test: install  ## Run pytests
-	@uv pip install pytest
-	@uv run pytest src/tests