HPC-workload-optimizer/Makefile at main · ErenAri/HPC-workload-optimizer · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
# HPC Workload Optimizer — Common Development Commands
# Cross-platform Makefile for consistent DX

.PHONY: lint typecheck test test-unit test-integration test-load coverage coverage-gate docs-check openapi-check readiness-check security serve docker-build docker-run rust-check clean verify help

# ---------------------------------------------------------------
# Code Quality
# ---------------------------------------------------------------

lint: ## Run ruff linter
	ruff check python/

typecheck: ## Run mypy type checker
	mypy python/hpcopt/ --ignore-missing-imports

security: ## Run Bandit SAST scanner
	bandit -r python/hpcopt/ -ll -ii

# ---------------------------------------------------------------
# Testing
# ---------------------------------------------------------------

test: ## Run full test suite
	pytest tests/ -v

test-unit: ## Run unit tests only
	pytest tests/unit/ -v

test-integration: ## Run integration tests only
	pytest tests/integration/ -v

test-load: ## Run load tests
	pytest tests/load/ -v -m load

coverage: ## Run tests with coverage reporting
	pytest tests/ -v --cov=hpcopt --cov-report=term-missing --cov-report=xml:coverage.xml --cov-fail-under=86

coverage-gate: coverage ## Enforce package-level coverage floors
	python scripts/check_coverage_thresholds.py --coverage-xml coverage.xml --global-fail-under 86 --package-threshold api=88 --package-threshold models=89 --package-threshold simulate=86

docs-check: ## Validate docs consistency against CLI/runtime interfaces
	python scripts/check_docs_consistency.py

openapi-check: ## Validate OpenAPI backward compatibility
	python scripts/check_openapi_compat.py --baseline schemas/openapi_baseline.json

readiness-check: ## Validate production readiness checklist shape
	python scripts/production_readiness_gate.py --mode validate

# ---------------------------------------------------------------
# Local Development
# ---------------------------------------------------------------

serve: ## Start local API server
	uvicorn hpcopt.api.app:app --reload --host 0.0.0.0 --port 8000

# ---------------------------------------------------------------
# Docker
# ---------------------------------------------------------------

docker-build: ## Build Docker image
	docker build -t hpcopt-api:dev .

docker-run: docker-build ## Run Docker container locally
	docker run --rm -p 8000:8000 hpcopt-api:dev

# ---------------------------------------------------------------
# Rust
# ---------------------------------------------------------------

rust-check: ## Run Rust checks (check, clippy, test)
	cd rust && cargo check --workspace
	cd rust && cargo clippy --workspace -- -D warnings
	cd rust && cargo test --workspace

# ---------------------------------------------------------------
# Dependencies
# ---------------------------------------------------------------

lock: ## Regenerate dependency lockfile
	pip-compile --generate-hashes --output-file=requirements.lock requirements.txt

# ---------------------------------------------------------------
# Maintenance
# ---------------------------------------------------------------

clean: ## Remove build artifacts and caches
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
	find . -type d -name .pytest_cache -exec rm -rf {} + 2>/dev/null || true
	find . -type d -name .mypy_cache -exec rm -rf {} + 2>/dev/null || true
	rm -rf dist/ build/ *.egg-info

verify: ## Run full CI-equivalent verification
	$(MAKE) lint typecheck security coverage-gate docs-check openapi-check readiness-check

help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'

.DEFAULT_GOAL := help