Makefile

# Milo CLI — development tasks (Python 3.14t, uv)

PYTHON_VERSION ?= 3.14t
VENV_DIR ?= .venv

.PHONY: all help setup install test test-cov lint format ty bench ci clean build gh-release changelog changelog-draft

all: help

help:
	@echo "milo-cli development"
	@echo "===================="
	@echo "Python: $(PYTHON_VERSION)"
	@echo ""
	@echo "  make setup     - uv venv with $(PYTHON_VERSION)"
	@echo "  make install   - uv sync --group dev"
	@echo "  make test      - pytest (tests/ only)"
	@echo "  make test-cov  - pytest + coverage (fail under 80%)"
	@echo "  make bench     - pytest-benchmark (benchmarks/)"
	@echo "  make lint      - ruff check"
	@echo "  make format    - ruff format"
	@echo "  make ty        - ty type checker"
	@echo "  make ci        - lint + format check + ty + tests + coverage"
	@echo "  make clean     - remove build artifacts"
	@echo "  make build     - uv build"
	@echo "  make changelog  - compile changelog.d/ fragments into CHANGELOG.md"
	@echo "  make changelog-draft - preview changelog without writing"
	@echo "  make gh-release - create GitHub release → triggers PyPI publish"

setup:
	uv venv --python $(PYTHON_VERSION) $(VENV_DIR)

install:
	uv sync --group dev

test:
	PYTHON_GIL=0 uv run pytest tests/ -q --tb=short --timeout=120

test-cov:
	PYTHON_GIL=0 uv run pytest tests/ -q --tb=short --timeout=120 \
		--cov=milo --cov-report=term-missing --cov-fail-under=80

bench:
	PYTHON_GIL=0 uv run pytest benchmarks/ --benchmark-only -q

lint:
	uv run ruff check src/ tests/ benchmarks/

format:
	uv run ruff format src/ tests/ benchmarks/

ty:
	uv run ty check src/milo/

ci: lint
	uv run ruff format src/ tests/ benchmarks/ --check
	$(MAKE) ty
	$(MAKE) test-cov

clean:
	rm -rf dist/ .pytest_cache .coverage coverage.xml htmlcov/

build:
	uv build

changelog:
	uv run towncrier build --yes

changelog-draft:
	uv run towncrier build --draft

# Create GitHub release from site release notes; triggers python-publish workflow → PyPI
# Strips YAML frontmatter (--- ... ---) from notes before passing to gh
gh-release:
	@VERSION=$$(grep -m1 '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/'); \
	PROJECT=$$(grep -m1 '^name = ' pyproject.toml | sed 's/name = "\(.*\)"/\1/'); \
	NOTES="site/content/releases/$$VERSION.md"; \
	if [ ! -f "$$NOTES" ]; then echo "Error: $$NOTES not found"; exit 1; fi; \
	echo "Creating release v$$VERSION for $$PROJECT..."; \
	git push origin main 2>/dev/null || true; \
	git push origin v$$VERSION 2>/dev/null || true; \
	awk '/^---$$/{c++;next}c>=2' "$$NOTES" | gh release create v$$VERSION \
		--title "$$PROJECT $$VERSION" \
		-F -; \
	echo "✓ GitHub release v$$VERSION created (PyPI publish will run via workflow)"