Makefile

.PHONY: help install format lint lint-fix typecheck docstring style fix \
        check sync clean test stats watch
.DEFAULT_GOAL := help

TEST_FLAGS := -xvv -s

install: ## Create / update virtual‑env with all dependency groups
	uv sync --all-groups

format: ## Format code using ruff
	uv run ruff format .

lint: ## Run linting using ruff
	uv run ruff check .

lint-fix: ## Run linting with automatic fixes
	uv run ruff check --fix .

typecheck: ## Run static type checking
	uv run pyright

docstring: ## Check docstring style and completeness
	uv run ruff check . --select D,PD

style: ## Check code style (without docstrings)
	uv run ruff check . --select E,W,F,I,N,UP,B,C4,SIM,TCH

fix: format lint-fix ## Run all formatters and fixers

check: fix 	typecheck ## Run all checks (format, lint‑fix, typecheck)

sync: ## Re‑lock and install latest versions
	uv lock --upgrade
	uv sync --all-groups --reinstall

clean: ## Remove build artefacts and caches
	rm -rf .ruff_cache/ .mypy_cache/ .pytest_cache/ dist/ build/
	find . -type d -name __pycache__ -exec rm -rf {} +

test: ## Run tests
	uv run pytest $(TEST_FLAGS)

stats: ## Show code quality statistics
	@echo "=== Docstring Coverage ==="
	@uv run ruff check . --select D --statistics
	@echo "\n=== Missing Type Hints ==="
	@uv run  ruff check . --select ANN --statistics
	@echo "\n=== Style Issues ==="
	@uv run  ruff check . --select E,W,F,I,N --statistics


# Watch tests, optionally limited to a path:
#   make watch                → watch entire suite
#   make watch path/to/file   → watch single test file
watch:
	@if [ -z "$(filter-out $@,$(MAKECMDGOALS))" ]; then \
		uv run pytest-watcher . -- tests $(TEST_FLAGS) -W ignore::DeprecationWarning; \
	else \
		path_arg="$(filter-out $@,$(MAKECMDGOALS))"; \
		uv run pytest-watcher . -- tests/$$path_arg $(TEST_FLAGS) -W ignore::DeprecationWarning; \
	fi

# Pattern rule so additional args do not trigger "No rule to make target"
%:
	@:

# Project‑specific entry points (replace poetry run → uv run)

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