itechmeat/llm-code/makefile

target: prerequisites
        recipe

# File target - creates/updates a file
build/app.o: src/app.c
        $(CC) -c $< -o $@
 
# Phony target - action, not a file
.PHONY: clean test install
 
clean:
        rm -rf build/

CC := gcc              # Immediate
CFLAGS ?= -O2          # Default, overridable
DEBUG = $(VERBOSE)     # Late binding
CFLAGS += -Wall        # Append

.DEFAULT_GOAL := help
 
help: ## Show available targets
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "  %-15s %s\n", $$1, $$2}'
 
install: ## Install dependencies
	uv sync
 
test: ## Run tests
	uv run pytest

UNAME_S := $(shell uname -s)
 
ifeq ($(UNAME_S),Darwin)
    OPEN := open
else ifeq ($(UNAME_S),Linux)
    OPEN := xdg-open
endif

BUILDDIR := build
SOURCES := $(wildcard src/*.c)
OBJECTS := $(patsubst src/%.c,$(BUILDDIR)/%.o,$(SOURCES))
 
$(BUILDDIR)/%.o: src/%.c | $(BUILDDIR)
	$(CC) -c $< -o $@
 
$(BUILDDIR):
	mkdir -p $@

export PYTHONPATH := $(PWD)/src
export DATABASE_URL
 
test:
	pytest tests/  # sees exported variables

.PHONY: lint format check test
 
lint: ## Run linters
	ruff check .
	mypy src/
 
format: ## Format code
	ruff format .
 
check: format lint test ## All quality checks

.PHONY: clean clean-all
 
clean: ## Remove build artifacts
	rm -rf build/ dist/ *.egg-info
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
 
clean-all: clean ## Remove all generated files
	rm -rf .venv .pytest_cache .mypy_cache

IMAGE := myapp
VERSION := $(shell git describe --tags --always)
 
docker-build: ## Build Docker image
	docker build -t $(IMAGE):$(VERSION) .
 
docker-run: ## Run container
	docker run -d -p 8000:8000 $(IMAGE):$(VERSION)

# Won't work - cd lost between lines
bad:
	cd subdir
	pwd           # Still in original dir!
 
# Correct - combine commands
good:
	cd subdir && pwd
 
# Or use line continuation
also-good:
	cd subdir && \
	pwd && \
	make

target:
	@echo "@ suppresses command echo"
	-rm -f maybe.txt    # - ignores errors

make -j4              # 4 parallel jobs
make -j4 lint test    # Run lint and test in parallel

# ❌ Too chatty
start:
	@echo "Starting services..."
	docker compose up -d
	@echo "Waiting..."
	@sleep 3
	@echo "Done!"
 
# ✅ Concise
start: ## Start services
	@echo "Starting at http://localhost:8000 ..."
	@docker compose up -d
	@echo "Logs: docker compose logs -f"

DEBUG ?= 0
 
ifeq ($(DEBUG),1)
    CFLAGS += -g -O0
else
    CFLAGS += -O2
endif
 
ifdef CI
    TEST_FLAGS := --ci
endif

# Required include (error if missing)
include config.mk
 
# Optional include (silent if missing)
-include local.mk
-include .env

# Makefile Template
.DEFAULT_GOAL := help
SHELL := /bin/bash
.SHELLFLAGS := -ec
 
.PHONY: help install test lint format clean
 
help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "  %-15s %s\n", $$1, $$2}'
 
install: ## Install dependencies
	uv sync --extra dev
 
test: ## Run tests
	uv run pytest tests/ -v
 
lint: ## Run linters
	uv run ruff check .
 
format: ## Format code
	uv run ruff format .
 
clean: ## Clean artifacts
	rm -rf build/ dist/ .pytest_cache