Makefile

.PHONY: help install install-dev test test-parallel lint format type-check clean build docs docs-serve publish

# Default target
help:
	@echo "GraphFlow - Makefile commands"
	@echo ""
	@echo "Setup:"
	@echo "  make install          Install package dependencies"
	@echo "  make install-dev      Install package + dev dependencies"
	@echo ""
	@echo "Development:"
	@echo "  make format           Format code with black and isort"
	@echo "  make lint             Run linting checks"
	@echo "  make type-check       Run type checking with mypy"
	@echo "  make test             Run tests"
	@echo "  make test-unit        Run unit tests only"
	@echo "  make test-integration Run integration tests only"
	@echo "  make test-performance Run performance tests only"
	@echo "  make test-async       Run async tests only"
	@echo "  make test-parallel    Run tests in parallel"
	@echo "  make test-coverage    Run tests with coverage report"
	@echo "  make test-fast        Run fast tests only (exclude slow)"
	@echo "  make test-all         Run all tests including performance"
	@echo "  make test-ci          Run CI test suite"
	@echo ""
	@echo "Documentation:"
	@echo "  make docs             Build documentation"
	@echo "  make docs-serve       Serve documentation locally"
	@echo ""
	@echo "Build & Release:"
	@echo "  make build            Build distribution packages"
	@echo "  make publish          Publish to PyPI"
	@echo "  make clean            Clean build artifacts"

# Installation
install:
	pip install -e .

install-dev:
	pip install -e ".[dev,distributed,cloud,visualization,all]"
	pip install mkdocs mkdocs-material mkdocstrings[python]

# Poetry installation (alternative)
install-poetry:
	poetry install

install-poetry-dev:
	poetry install --all-extras

# Code quality
format:
	@echo "Formatting code with black..."
	black graphflow/ tests/ examples/ --line-length 88
	@echo "Sorting imports with isort..."
	isort graphflow/ tests/ examples/ --profile black

lint:
	@echo "Running flake8..."
	flake8 graphflow/ tests/ --max-line-length 88 --extend-ignore E203,W503
	@echo "Running pylint..."
	pylint graphflow/ --rcfile=.pylintrc || true

type-check:
	@echo "Running mypy type checks..."
	mypy graphflow/ --ignore-missing-imports --python-version 3.11

# Testing
test:
	@echo "Running tests..."
	pytest tests/ -v

test-unit:
	@echo "Running unit tests..."
	pytest tests/ -v -m "unit"

test-integration:
	@echo "Running integration tests..."
	pytest tests/ -v -m "integration"

test-performance:
	@echo "Running performance tests..."
	pytest tests/ -v -m "performance"

test-async:
	@echo "Running async tests..."
	pytest tests/ -v -m "async"

test-parallel:
	@echo "Running tests in parallel..."
	pytest tests/ -v -n auto --dist loadgroup

test-coverage:
	@echo "Running tests with coverage..."
	pytest tests/ -v --cov=graphflow --cov-report=html --cov-report=term-missing
	@echo "Coverage report generated in htmlcov/index.html"

test-fast:
	@echo "Running fast tests only..."
	pytest tests/ -v -m "not slow"

test-all:
	@echo "Running all tests including performance..."
	pytest tests/ -v

test-ci:
	@echo "Running CI test suite..."
	pytest tests/ -c pytest-fast.ini --cov=graphflow --cov-report=xml --cov-report=html --timeout=180

# Documentation
docs:
	@echo "Building documentation..."
	mkdocs build

docs-serve:
	@echo "Serving documentation at http://127.0.0.1:8000"
	mkdocs serve

# Build and publish
build: clean
	@echo "Building distribution packages..."
	python -m build

publish: build
	@echo "Publishing to PyPI..."
	python -m twine upload dist/*

clean:
	@echo "Cleaning build artifacts..."
	rm -rf build/
	rm -rf dist/
	rm -rf *.egg-info
	rm -rf htmlcov/
	rm -rf .coverage
	rm -rf .pytest_cache/
	rm -rf .mypy_cache/
	find . -type d -name __pycache__ -exec rm -rf {} +
	find . -type f -name "*.pyc" -delete
	find . -type f -name "*.pyo" -delete

# Comprehensive check before commit
check: format lint type-check test-parallel
	@echo "All checks passed! ✅"