Makefile

# ScriptMate Makefile

.PHONY: help install dev test test-cov lint format build clean publish publish-test \
        version-patch version-minor version-major check-version status setup-dev \
        check-deps security-check docs serve-docs

# Default target
help:
	@echo "🚀 ScriptMate Development Tools"
	@echo ""
	@echo "📦 Project Management:"
	@echo "  install       Install project dependencies"
	@echo "  dev           Install development dependencies"
	@echo "  setup-dev     Complete development environment setup"
	@echo "  status        Show project status"
	@echo ""
	@echo "🧪 Testing and Quality:"
	@echo "  test          Run tests"
	@echo "  test-cov      Run tests with coverage report"
	@echo "  lint          Code linting"
	@echo "  format        Code formatting"
	@echo "  security-check Security check"
	@echo ""
	@echo "🔧 Build and Publish:"
	@echo "  build         Build package"
	@echo "  clean         Clean build files"
	@echo "  publish       Publish to PyPI"
	@echo "  publish-test  Publish to test PyPI"
	@echo ""
	@echo "📝 Version Management:"
	@echo "  check-version Check current version"
	@echo "  version-patch Bump patch version and publish"
	@echo "  version-minor Bump minor version and publish"
	@echo "  version-major Bump major version and publish"
	@echo ""
	@echo "📚 Documentation:"
	@echo "  docs          Generate documentation"
	@echo "  serve-docs    Start documentation server"

# Project Management
install:
	@echo "📦 Installing project dependencies..."
	uv sync

dev:
	@echo "🔧 Installing development dependencies..."
	uv sync --dev
	@if command -v pre-commit >/dev/null 2>&1 || uv run pre-commit --version >/dev/null 2>&1; then \
		uv run pre-commit install; \
		echo "✅ pre-commit hooks installed"; \
	else \
		echo "⚠️  pre-commit not found, skipping hooks installation"; \
	fi

setup-dev: dev
	@echo "🚀 Setting up complete development environment..."
	@echo "✅ Development environment setup complete"

status:
	@echo "📊 Project Status:"
	@echo "Current version: $$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/')"
	@echo "Python version: $$(uv run python --version)"
	@echo "UV version: $$(uv --version)"
	@if [ -d ".git" ]; then \
		echo "Git branch: $$(git branch --show-current 2>/dev/null || echo 'unknown')"; \
		echo "Git status: $$(git status --porcelain | wc -l | tr -d ' ') uncommitted changes"; \
	fi

check-deps:
	@echo "🔍 Checking dependencies..."
	uv tree

# Testing and Quality
test:
	@echo "🧪 Running tests..."
	uv run pytest -v

test-cov:
	@echo "🧪 Running tests with coverage report..."
	uv run pytest --cov=src --cov-report=html --cov-report=term-missing

lint:
	@echo "🔍 Code linting..."
	@echo "Checking code format..."
	uv run black --check src/ tests/ || (echo "❌ Black format check failed" && exit 1)
	@echo "Checking import sorting..."
	uv run isort --check-only src/ tests/ || (echo "❌ isort check failed" && exit 1)
	@if command -v flake8 >/dev/null 2>&1 || uv run flake8 --version >/dev/null 2>&1; then \
		echo "Checking code style..."; \
		uv run flake8 src/ tests/ || (echo "❌ flake8 check failed" && exit 1); \
	fi
	@if command -v mypy >/dev/null 2>&1 || uv run mypy --version >/dev/null 2>&1; then \
		echo "Type checking..."; \
		uv run mypy src/ || (echo "❌ mypy check failed" && exit 1); \
	fi
	@echo "✅ All checks passed"

format:
	@echo "🎨 Code formatting..."
	uv run black src/ tests/
	uv run isort src/ tests/
	@echo "✅ Code formatting complete"

security-check:
	@echo "🔒 Security check..."
	@if command -v bandit >/dev/null 2>&1 || uv run bandit --version >/dev/null 2>&1; then \
		uv run bandit -r src/; \
	else \
		echo "⚠️  bandit not installed, skipping security check"; \
	fi

# Build and Clean
build: clean
	@echo "🔨 Building package..."
	uv build
	@echo "✅ Build complete"

clean:
	@echo "🧹 Cleaning build files..."
	rm -rf build/ dist/ src/*.egg-info/ .pytest_cache/ htmlcov/ .coverage
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
	find . -type f -name "*.pyc" -delete 2>/dev/null || true
	find . -type f -name "*.pyo" -delete 2>/dev/null || true
	@echo "✅ Clean complete"

# Publishing
publish: lint test build
	@echo "🚀 Publishing to PyPI..."
	@if [ ! -f ~/.pypirc ] && [ -z "$$TWINE_PASSWORD" ]; then \
		echo "❌ Error: PyPI authentication required"; \
		echo "Please set environment variables:"; \
		echo "  export TWINE_USERNAME=__token__"; \
		echo "  export TWINE_PASSWORD=your-api-token"; \
		echo "or create ~/.pypirc configuration file"; \
		exit 1; \
	fi
	@echo "📦 Uploading package to PyPI..."
	uv run twine upload dist/*
	@echo "✅ Published successfully!"

publish-test: lint test build
	@echo "🧪 Publishing to test PyPI..."
	@if [ ! -f ~/.pypirc ] && [ -z "$$TWINE_PASSWORD" ]; then \
		echo "❌ Error: PyPI authentication required"; \
		echo "Please set environment variables:"; \
		echo "  export TWINE_USERNAME=__token__"; \
		echo "  export TWINE_PASSWORD=your-test-api-token"; \
		echo "or create ~/.pypirc configuration file"; \
		exit 1; \
	fi
	@echo "📦 Uploading package to test PyPI..."
	uv run twine upload --repository testpypi dist/*
	@echo "✅ Test publish successful!"

# Version Management
check-version:
	@echo "📋 Current version information:"
	@current_version=$$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/'); \
	echo "Current version: $$current_version"

version-patch:
	@echo "🔖 Bumping patch version..."
	@current_version=$$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/'); \
	new_version=$$(uv run python -c "import sys; v=sys.argv[1].split('.'); v[2]=str(int(v[2])+1); print('.'.join(v))" $$current_version); \
	if [ "$$(uname)" = "Darwin" ]; then \
		sed -i '' "s/^version = .*/version = \"$$new_version\"/" pyproject.toml; \
	else \
		sed -i "s/^version = .*/version = \"$$new_version\"/" pyproject.toml; \
	fi; \
	echo "✅ Version updated to: $$new_version"; \
	git add pyproject.toml && git commit -m "bump version to $$new_version" || true; \
	$(MAKE) publish

version-minor:
	@echo "🔖 Bumping minor version..."
	@current_version=$$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/'); \
	new_version=$$(uv run python -c "import sys; v=sys.argv[1].split('.'); v[1]=str(int(v[1])+1); v[2]='0'; print('.'.join(v))" $$current_version); \
	if [ "$$(uname)" = "Darwin" ]; then \
		sed -i '' "s/^version = .*/version = \"$$new_version\"/" pyproject.toml; \
	else \
		sed -i "s/^version = .*/version = \"$$new_version\"/" pyproject.toml; \
	fi; \
	echo "✅ Version updated to: $$new_version"; \
	git add pyproject.toml && git commit -m "bump version to $$new_version" || true; \
	$(MAKE) publish

version-major:
	@echo "🔖 Bumping major version..."
	@current_version=$$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/'); \
	new_version=$$(uv run python -c "import sys; v=sys.argv[1].split('.'); v[0]=str(int(v[0])+1); v[1]='0'; v[2]='0'; print('.'.join(v))" $$current_version); \
	if [ "$$(uname)" = "Darwin" ]; then \
		sed -i '' "s/^version = .*/version = \"$$new_version\"/" pyproject.toml; \
	else \
		sed -i "s/^version = .*/version = \"$$new_version\"/" pyproject.toml; \
	fi; \
	echo "✅ Version updated to: $$new_version"; \
	git add pyproject.toml && git commit -m "bump version to $$new_version" || true; \
	$(MAKE) publish

# Documentation
docs:
	@echo "📚 Generating documentation..."
	@if [ -f "docs/conf.py" ] || [ -f "mkdocs.yml" ]; then \
		if [ -f "mkdocs.yml" ]; then \
			uv run mkdocs build; \
		elif [ -f "docs/conf.py" ]; then \
			cd docs && uv run sphinx-build -b html . _build/html; \
		fi; \
		echo "✅ Documentation generation complete"; \
	else \
		echo "⚠️  Documentation configuration file not found"; \
	fi

serve-docs:
	@echo "🌐 Starting documentation server..."
	@if [ -f "mkdocs.yml" ]; then \
		uv run mkdocs serve; \
	elif [ -f "docs/conf.py" ]; then \
		cd docs && uv run sphinx-autobuild . _build/html; \
	else \
		echo "⚠️  Documentation configuration file not found"; \
	fi