PYTHON ?= python3 BASE_URL ?= http://localhost:8080 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) .PHONY: help check validate test load test-persistence test-failover help: @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes" check: $(PYTHON) scripts/check_contract.py validate: $(PYTHON) scripts/validate_openapi.py test: $(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS) load: $(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-persistence: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2) $(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) test-failover: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) .PHONY: test-idempotency up down up: ./scripts/bootstrap.sh ./scripts/compose.sh up -d --build down: ./scripts/compose.sh down test-idempotency: $(PYTHON) tests/idempotency_concurrent.py --base-url "$(BASE_URL)" .PHONY: test-replicas test-rolling research-scaling plot-scaling # The target image must already be built; API_IMAGE selects it. test-rolling: $(PYTHON) tests/rolling_update.py --base-url "$(BASE_URL)" test-replicas: $(PYTHON) tests/replica_matrix.py --base-url "$(BASE_URL)" research-scaling: $(PYTHON) scripts/research_scaling.py --base-url "$(BASE_URL)" plot-scaling: $(PYTHON) scripts/plot_scaling.py $(PYTHON) scripts/summarize_research.py .PHONY: test-cache # Run inside the private Compose network; no DB/cache ports are exposed. test-cache: ./scripts/compose.sh exec -T -e BASE_URL=http://lb:8080 -e CACHE_URL=redis://valkey:6379/0 api python - < tests/cache_consistency.py