Makefile

# ===========================
# Project Configuration
# ===========================
VENV := .venv
PYTHON := $(VENV)/bin/python
PIP := $(VENV)/bin/pip
PACKAGE := iocx

# Stamp files to avoid repeated work
STAMP_VENV := .venv.created
STAMP_INSTALL := .venv.installed
STAMP_DEV := .venv.devtools

# Tests
PYTEST := pytest
INTEGRATION_DIR := tests/integration
FUZZ_DIR := tests/fuzz
ROBUSTNESS_DIR := tests/robustness
PERFORMANCE_DIR := tests/performance
CONTRACT_DIR := tests/contract

.PHONY: activate
activate:
	@echo "Run: source .venv/bin/activate"

# ===========================
# Help
# ===========================
.PHONY: help
help:
	@echo ""
	@echo "Available commands:"
	@echo "  make venv          Create virtual environment (only once)"
	@echo "  make install       Install package in editable mode"
	@echo "  make dev           Install dev tools (pytest, ruff, black, coverage, pip-audit, bandit, pytest-timeout)"
	@echo "  make test          Run unit test suite only"
	@echo "  make test-[option] Run test suite (option=contract, fuzz, integration, performance, robustness, coverage)"
	@echo "  make security      Run security scans (pip-audit, bandit)"
	@echo "  make lint          Run ruff linter"
	@echo "  make format        Auto-format with black"
	@echo "  make run           Run CLI tool"
	@echo "  make clean         Remove build artifacts"
	@echo "  make clean-all     Remove build artifacts and virtual environment"
	@echo "  make dist          Build wheel + sdist"
	@echo "  make reset         Delete venv and reinstall everything"
	@echo ""


# ===========================
# Virtual Environment
# ===========================
$(STAMP_VENV):
	python3 -m venv $(VENV)
	@touch $(STAMP_VENV)
	@echo "Virtual environment created at $(VENV)"

venv: $(STAMP_VENV)


# ===========================
# Install Package
# ===========================
$(STAMP_INSTALL): venv
	$(PIP) install -e .
	@touch $(STAMP_INSTALL)
	@echo "Package installed in editable mode"

install: $(STAMP_INSTALL)


# ===========================
# Development Tools
# ===========================
$(STAMP_DEV): install
	$(PIP) install pytest ruff black coverage pip-audit bandit pytest-timeout
	@touch $(STAMP_DEV)
	@echo "Development tools installed"

dev: $(STAMP_DEV)


# ===========================
# Testing
# ===========================
.PHONY: test
test: dev
	$(PYTHON) -m pytest -q -m "not integration and not fuzz and not robustness and not performance and not contract"

# ----------------------------------------
# Integration tests only
# ----------------------------------------
.PHONY: test-integration
test-integration: dev
	@echo "Running integration tests..."
	$(PYTEST) -m integration $(INTEGRATION_DIR)

# ----------------------------------------
# Fuzz tests only
# ----------------------------------------
.PHONY: test-fuzz
test-fuzz: dev
	@echo "Running fuzz tests..."
	$(PYTEST) -m fuzz $(FUZZ_DIR)

# ----------------------------------------
# Resilience/chaos tests only
# ----------------------------------------
.PHONY: test-robustness
test-robustness: dev
	@echo "Running robustness tests..."
	$(PYTEST) -m robustness $(ROBUSTNESS_DIR)

# ----------------------------------------
# Performance tests only
# ----------------------------------------
.PHONY: test-performance
test-performance: dev
	@echo "Running performance tests..."
	$(PYTEST) -m performance $(PERFORMANCE_DIR) -q -s

# ----------------------------------------
# Tests with coverage
# ----------------------------------------
.PHONY: test-coverage
test-coverage: dev
	$(PYTHON) -m coverage run -m pytest
	$(PYTHON) -m coverage report -m

# ----------------------------------------
# Contract tests only
# ----------------------------------------
.PHONY: test-contract
test-contract: dev
	@echo "Running contract tests..."
	$(PYTEST) -m contract $(CONTRACT_DIR) -sv

# ----------------------------------------
# Static analysis and SCA
# ----------------------------------------
.PHONY: security
security: dev
	@echo "Running pip-audit..."
	-$(VENV)/bin/pip-audit --skip-editable
	@echo "Running Bandit..."
	$(VENV)/bin/bandit -r $(PACKAGE) -lll

# ===========================
# Linting & Formatting
# ===========================
.PHONY: lint
lint: dev
	$(VENV)/bin/ruff check $(PACKAGE)

.PHONY: format
format: dev
	$(VENV)/bin/black $(PACKAGE)


# ===========================
# Run CLI
# ===========================
.PHONY: run
run: install
	$(PYTHON) -m $(PACKAGE).cli.main $(ARGS)


# ===========================
# Build Distribution
# ===========================
.PHONY: dist
dist: install
	$(PYTHON) -m build


# ===========================
# Clean
# ===========================
.PHONY: clean
clean:
	rm -rf build dist *.egg-info
	find . -name "__pycache__" -type d -exec rm -rf {} +
	@echo "Cleaned build artifacts"

.PHONY: clean-all
clean-all:
	rm -rf build dist *.egg-info
	rm -rf .pytest_cache
	find . -name "__pycache__" -type d -exec rm -rf {} +
	find . -name "*.pyc" -delete
	rm -rf $(VENV)
	rm -f $(STAMP_VENV) $(STAMP_INSTALL) $(STAMP_DEV)
	make dev

# ===========================
# Reset Everything
# ===========================
.PHONY: reset
reset:
	rm -rf $(VENV)
	rm -f $(STAMP_VENV) $(STAMP_INSTALL) $(STAMP_DEV)
	make dev

# ===========================
# Go Toolchain Check
# ===========================

.PHONY: check-go
check-go:
	@command -v go >/dev/null 2>&1 || { \
        echo "Error: Go is not installed or not on PATH."; \
        echo "Install it with: sudo apt install golang-go"; \
        exit 1; \
	}

# ===========================
# Synthetic Sample Generation
# ===========================

GENERATOR_SCRIPTS := $(filter-out %/__init__.py, $(wildcard examples/generators/**/*.py))
SAMPLES := $(patsubst examples/generators/%.py, examples/samples/exe/%.exe, $(GENERATOR_SCRIPTS))

.PHONY: samples
samples: $(SAMPLES)
	@echo "All synthetic samples generated."

examples/samples/exe/%.exe: examples/generators/%.py
	@mkdir -p examples/samples/exe
	$(PYTHON) $< $@
	@echo "Generated sample: $@"

.PHONY: clean-samples
clean-samples:
	rm -rf examples/samples/exe
	@echo "Removed all synthetic samples."