# Makefile for Rust plugins (Workspace)
# Copyright 2025
# SPDX-License-Identifier: Apache-2.0
#
# WORKSPACE vs PLUGIN OPERATIONS
#
# Workspace operations (this Makefile):
# make dev - Build & install plugins_rust (all plugins aggregated)
# make test - Test all plugins in workspace
# make bench - Benchmark all plugins
#
# Plugin operations (plugin-specific Makefile):
# cd pii_filter && make dev - Build & install pii_filter_rust only
# cd pii_filter && make test - Test pii_filter only
# make plugin-pii-filter-dev - Same as above (delegate from workspace)
#
# Use plugin-specific operations for faster iteration during development.
# Use workspace operations for integration testing and releases.
.PHONY: help build dev test clean check lint fmt bench audit doc install
# Default target
.DEFAULT_GOAL := help
# Colors for output
BLUE := \033[0;34m
GREEN := \033[0;32m
YELLOW := \033[0;33m
RED := \033[0;31m
NC := \033[0m # No Color
help: ## Show this help message
@echo "$(BLUE)Rust Plugins Makefile (Workspace)$(NC)"
@echo ""
@echo "$(GREEN)Available targets:$(NC)"
@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf " $(BLUE)%-20s$(NC) %s\n", $$1, $$2}'
@echo ""
@echo "$(YELLOW)Workspace Examples:$(NC)"
@echo " make dev # Build and install plugins_rust (all plugins)"
@echo " make test # Run tests for all plugins"
@echo " make bench # Run benchmarks for all plugins"
@echo ""
@echo "$(YELLOW)Plugin Examples:$(NC)"
@echo " cd pii_filter && make dev"
# Build targets (workspace aggregate)
build: ## Build workspace aggregate module (plugins_rust)
@echo "$(GREEN)Building workspace module (plugins_rust)...$(NC)"
maturin build --release
build-debug: ## Build workspace module (debug)
@echo "$(YELLOW)Building workspace module (debug)...$(NC)"
maturin build
dev: ## Build and install workspace module (plugins_rust) in development mode
@echo "$(GREEN)Building and installing workspace module (plugins_rust)...$(NC)"
maturin develop --release
dev-debug: ## Build and install workspace module (debug) in development mode
@echo "$(YELLOW)Building workspace module (debug)...$(NC)"
maturin develop
install: ## Build and install workspace module (uses maturin develop)
@echo "$(GREEN)Installing workspace module...$(NC)"
maturin develop --release
@echo "$(GREEN)Verifying installation...$(NC)"
@python -c "import plugins_rust; import os; import time; stat = os.stat(plugins_rust.__file__); print('✓ plugins_rust installed at:', plugins_rust.__file__); print('✓ Version:', getattr(plugins_rust, '__version__', 'unknown')); print('✓ Install time:', time.ctime(stat.st_mtime))" || { echo "$(RED)Installation verification failed!$(NC)"; exit 1; }
@echo "$(GREEN)Installation verified successfully!$(NC)"
# Testing targets (workspace)
test: ## Run Rust tests for all plugins in workspace
@echo "$(GREEN)Running workspace tests...$(NC)"
cargo test --workspace
test-verbose: ## Run workspace tests (verbose)
@echo "$(GREEN)Running workspace tests (verbose)...$(NC)"
cargo test --workspace --verbose
test-python: ## Run Python tests for workspace (requires dev install)
@echo "$(GREEN)Running Python unit tests...$(NC)"
cd .. && uv run pytest tests/unit/mcpgateway/plugins/ -k rust -v
test-differential: ## Run differential tests (Rust vs Python)
@echo "$(GREEN)Running differential tests...$(NC)"
cd .. && uv run pytest tests/differential/ -k differential -v
fmt: ## Format code with rustfmt
@echo "$(GREEN)Formatting code...$(NC)"
cargo fmt --all
fmt-check: ## Check if code is formatted
@echo "$(GREEN)Checking code format...$(NC)"
cargo fmt --all -- --check
clippy: ## Run clippy linter
@echo "$(GREEN)Running clippy...$(NC)"
cargo clippy --all-targets --all-features -- -D warnings
# Benchmarking targets (workspace)
bench: ## Run Rust benchmarks for all plugins
@echo "$(GREEN)Running workspace benchmarks...$(NC)"
cargo bench --workspace
bench-compare: ## Run Python comparison benchmarks for all plugins
@echo "$(GREEN)Running Python vs Rust comparison benchmarks...$(NC)"
@test -d "$(HOME)/.venv/mcpgateway" || { echo "$(RED)Virtual environment not found. Run 'make venv' from project root first.$(NC)"; exit 1; }
@for dir in */benchmarks; do \
if [ -d "$$dir" ]; then \
plugin=$$(dirname "$$dir"); \
echo "$(BLUE)Running benchmarks for $$plugin...$(NC)"; \
if [ -f "$$dir/compare_$${plugin}.py" ]; then \
cd "$$plugin" && $(HOME)/.venv/mcpgateway/bin/python benchmarks/compare_$${plugin}.py && cd ..; \
else \
echo "$(YELLOW)No compare script found for $$plugin$(NC)"; \
fi; \
fi; \
done
bench-all: bench bench-compare ## Run all benchmarks (Rust + Python comparison)
@echo "$(GREEN)All benchmarks completed!$(NC)"
# Security and audit targets
audit: ## Run security audit with cargo-audit
@echo "$(GREEN)Running security audit...$(NC)"
@command -v cargo-audit >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-audit...$(NC)"; cargo install cargo-audit; }
cargo audit
audit-fix: ## Run security audit and apply fixes
@echo "$(GREEN)Running security audit with fixes...$(NC)"
cargo audit fix
# Documentation targets
doc: ## Build Rust documentation
@echo "$(GREEN)Building documentation...$(NC)"
cargo doc --workspace --no-deps --document-private-items
doc-open: doc ## Build and open documentation in browser
@echo "$(GREEN)Opening documentation...$(NC)"
cargo doc --workspace --no-deps --document-private-items --open
# Coverage targets
coverage: ## Generate code coverage report
@echo "$(GREEN)Generating code coverage...$(NC)"
@command -v cargo-tarpaulin >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-tarpaulin...$(NC)"; cargo install cargo-tarpaulin; }
cargo tarpaulin --workspace --lib --no-default-features --out Html --out Xml --output-dir coverage
# Cleaning targets
clean: ## Remove build artifacts
@echo "$(YELLOW)Cleaning build artifacts...$(NC)"
cargo clean
rm -rf dist/
rm -rf target/
rm -rf coverage/
rm -f Cargo.lock
find . -type f -name "*.whl" -delete
find . -type f -name "*.pyc" -delete
find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
@echo "$(YELLOW)Cleaning benchmark results...$(NC)"
rm -f benchmarks/results/*.json
rm -f benchmarks/results/*.csv
clean-all: clean ## Remove all generated files including caches
@echo "$(RED)Cleaning all generated files...$(NC)"
rm -rf ~/.cargo/registry/cache/
rm -rf ~/.cargo/git/db/
info: ## Show build information
@echo "$(BLUE)Build Information:$(NC)"
@echo " Rust version: $$(rustc --version)"
@echo " Cargo version: $$(cargo --version)"
@echo " Maturin version: $$(maturin --version 2>/dev/null || echo 'not installed')"
@echo " Python version: $$(python --version)"
@echo ""
@echo "$(BLUE)Workspace Information:$(NC)"
@echo " Name: plugins_rust (workspace aggregate)"
@echo " Version: $$(grep '^version' Cargo.toml | head -1 | cut -d'"' -f2)"
@echo " License: Apache-2.0"
@echo " Plugins: pii_filter"
deps: ## Install/update dependencies
@echo "$(GREEN)Installing/updating dependencies...$(NC)"
@command -v maturin >/dev/null 2>&1 || { echo "$(YELLOW)Installing maturin...$(NC)"; pip install maturin; }
@command -v cargo-audit >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-audit...$(NC)"; cargo install cargo-audit; }
@command -v cargo-tarpaulin >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-tarpaulin...$(NC)"; cargo install cargo-tarpaulin; }
@command -v cargo-upgrade >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-edit (cargo-upgrade)...$(NC)"; cargo install cargo-edit; }
@command -v cargo-outdated >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-outdated...$(NC)"; cargo install cargo-outdated; }
@echo "$(GREEN)Dependencies installed!$(NC)"
upgrade-deps-check: ## Check for outdated dependencies (dry-run)
@echo "$(GREEN)Checking for outdated dependencies...$(NC)"
@command -v cargo-outdated >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-outdated...$(NC)"; cargo install cargo-outdated; }
cargo outdated
upgrade-deps: ## Update dependencies to latest versions
@echo "$(GREEN)Updating Rust dependencies to latest versions...$(NC)"
@command -v cargo-upgrade >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-edit (cargo-upgrade)...$(NC)"; cargo install cargo-edit; }
@echo "$(YELLOW)Running cargo upgrade --incompatible...$(NC)"
cargo upgrade --incompatible
@echo "$(YELLOW)Updating Cargo.lock...$(NC)"
cargo update
@echo "$(YELLOW)Building release to verify compatibility...$(NC)"
cargo build --release
@echo "$(YELLOW)Running tests to verify functionality...$(NC)"
cargo test --lib --bins --no-default-features
@echo "$(GREEN)Dependencies updated successfully!$(NC)"
@echo "$(YELLOW)Review changes with: git diff Cargo.toml Cargo.lock$(NC)"
# Release targets
release-build: clean ## Build release packages for all platforms
@echo "$(GREEN)Building release packages...$(NC)"
maturin build --release --out dist
# Watch targets (requires cargo-watch)
watch: ## Watch for changes and run tests
@command -v cargo-watch >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-watch...$(NC)"; cargo install cargo-watch; }
cargo watch -x test
watch-dev: ## Watch for changes and rebuild in dev mode
@command -v cargo-watch >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-watch...$(NC)"; cargo install cargo-watch; }
cargo watch -x 'maturin develop'
# Performance profiling
profile: ## Profile Rust code with flamegraph
@command -v cargo-flamegraph >/dev/null 2>&1 || { echo "$(YELLOW)Installing cargo-flamegraph...$(NC)"; cargo install flamegraph; }
@echo "$(GREEN)Profiling with flamegraph...$(NC)"
@echo "$(YELLOW)Note: Specify benchmark with --bench flag$(NC)"
cargo flamegraph --workspace
# Statistics
stats: ## Show code statistics
@echo "$(BLUE)Code Statistics:$(NC)"
@echo " Rust files: $$(find src -name '*.rs' | wc -l)"
@echo " Rust lines: $$(find src -name '*.rs' -exec cat {} \; | wc -l)"
@echo " Test files: $$(find tests -name '*.rs' | wc -l)"
@echo " Test lines: $$(find tests -name '*.rs' -exec cat {} \; | wc -l)"
@echo " Bench files: $$(find benches -name '*.rs' 2>/dev/null | wc -l)"
@echo ""
@echo "$(BLUE)Dependency Tree:$(NC)"
@cargo tree --depth 1
# All PHONY targets
.PHONY: help build build-debug dev dev-debug install \
test test-verbose test-python test-differential \
fmt fmt-check clippy \
bench bench-compare bench-all \
audit audit-fix \
doc doc-open \
coverage \
clean clean-all \
info deps upgrade-deps-check upgrade-deps \
release-build \
watch watch-dev profile stats
