Makefile

# ============================================================
# Makefile — Developer shortcuts
# ============================================================
# Usage:
#   make install        Install all dependencies
#   make run            Start the API server (local)
#   make docker-up      Start the full stack with Docker
#   make test           Run the test suite
#   make type-check     Run mypy strict type checking
#   make clean          Remove build artifacts
# ============================================================

.PHONY: install run docker-up docker-down test type-check lint clean help

# ── Setup ─────────────────────────────────────────────────────

install:
	@echo "Installing dependencies..."
	pip install -r requirements.txt
	@echo "✓ Done"

# ── Run ───────────────────────────────────────────────────────

run:
	@echo "Starting API server on http://localhost:8000"
	@echo "Swagger UI: http://localhost:8000/docs"
	uvicorn api.main:app --reload --host 0.0.0.0 --port 8000

run-worker:
	@echo "Starting standalone worker daemon..."
	python worker_daemon.py

run-demo:
	@echo "Running full demo (no HTTP, no Redis)..."
	python main.py

# ── Docker ────────────────────────────────────────────────────

docker-up:
	@echo "Starting full stack: Redis + API + Worker"
	docker-compose up --build

docker-up-detached:
	docker-compose up --build -d
	@echo "Stack running in background."
	@echo "  API:      http://localhost:8000/docs"
	@echo "  Redis UI: docker-compose --profile debug up"

docker-down:
	docker-compose down -v
	@echo "✓ Stack stopped and volumes removed"

docker-logs:
	docker-compose logs -f api worker

docker-redis-cli:
	docker exec -it tq-redis redis-cli

# ── Testing ───────────────────────────────────────────────────

test:
	@echo "Running test suite..."
	python -m pytest tests/ -v --tb=short

test-original:
	@echo "Running original test suite (no pytest)..."
	python -m unittest tests.test_system -v

test-api:
	@echo "Running API integration tests..."
	python -m pytest tests/test_api.py -v --tb=short

test-all:
	@echo "Running ALL tests..."
	python -m pytest tests/ -v --tb=short -x

# ── Quality ───────────────────────────────────────────────────

type-check:
	@echo "Running mypy strict type checking..."
	mypy . --ignore-missing-imports --exclude venv

lint:
	@echo "Linting with ruff..."
	ruff check . --fix

# ── Utilities ─────────────────────────────────────────────────

clean:
	find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
	find . -name "*.pyc" -delete 2>/dev/null || true
	find . -name "*.pyo" -delete 2>/dev/null || true
	find . -name ".mypy_cache" -exec rm -rf {} + 2>/dev/null || true
	find . -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
	@echo "✓ Cleaned"

help:
	@echo ""
	@echo "  Task Queue System — Make targets"
	@echo "  ─────────────────────────────────"
	@echo "  make install           Install dependencies"
	@echo "  make run               Start API server locally"
	@echo "  make run-demo          Run the demo script (no HTTP)"
	@echo "  make docker-up         Full stack via Docker"
	@echo "  make docker-down       Stop Docker stack"
	@echo "  make test              Run test suite"
	@echo "  make type-check        mypy strict check"
	@echo "  make clean             Remove build artifacts"
	@echo ""