118 lines
4.7 KiB
Makefile
118 lines
4.7 KiB
Makefile
# DESI Explorer — root Makefile
|
|
#
|
|
# Lean orchestrator: the "base" commands (`run`, `build`, `test`, ...) delegate
|
|
# into the per-project Makefiles in `gui/`, `api/`, and `infra/`. Project-
|
|
# specific commands live in those directories and are reached with
|
|
# `make -C <dir> <target>` (or the thin passthrough targets below).
|
|
|
|
GUI := gui
|
|
API := api
|
|
INFRA := infra
|
|
|
|
# Local dev/test assets live under resources/dev. These are the defaults for
|
|
# the run/*-web targets; override any of them on the command line, e.g.
|
|
# make run GUI_ENV_FILE=/path/to/gui.env API_DESI_DATA=/path/to/data.json
|
|
RESOURCE_DIR := $(CURDIR)/resources/dev
|
|
GUI_ENV_FILE ?= $(RESOURCE_DIR)/gui.env.example
|
|
API_ENV_FILE ?= $(RESOURCE_DIR)/api.env.example
|
|
API_DESI_DATA ?= $(RESOURCE_DIR)/desi_subset.json
|
|
# The API binds here for local dev (see api/src/config.rs); `make run` passes
|
|
# it through and waits for $(API_HEALTH_URL) to respond before launching the
|
|
# GUI, so the renderer never races the API on startup. A bind host of
|
|
# 0.0.0.0 is probed via 127.0.0.1. Adjust API_WAIT_TIMEOUT (seconds) if the
|
|
# API takes longer than 60s to become healthy on a given machine.
|
|
API_BIND_ADDR ?= 127.0.0.1:8080
|
|
API_HEALTH_URL := http://$(subst 0.0.0.0,127.0.0.1,$(API_BIND_ADDR))/health
|
|
API_WAIT_TIMEOUT ?= 60
|
|
|
|
.PHONY: help setup run run-web build build-debug build-web test clean fmt \
|
|
api-wait renovate-validate
|
|
|
|
help: ## List available targets
|
|
@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
|
|
awk 'BEGIN {FS = ":.*?## "}; {printf " \033[36m%-18s\033[0m %s\n", $$1, $$2}'
|
|
@echo ""
|
|
@echo "Sub-project targets:"
|
|
@echo " \033[36mmake -C gui help\033[0m Odin renderer (run, build, build-web, test, fmt, ...)"
|
|
@echo " \033[36mmake -C api help\033[0m Rust API (run, build, test, check, fmt, ...)"
|
|
@echo " \033[36mmake -C infra help\033[0m Infra (preview, up, down, refresh, test, ...)"
|
|
|
|
## ---- Setup ---------------------------------------------------------------
|
|
|
|
setup: ## Setup all sub-projects (submodules, gui deps, api deps, infra deps)
|
|
@git submodule update --init --recursive
|
|
@$(MAKE) -C $(GUI) setup
|
|
@$(MAKE) -C $(API) setup
|
|
@$(MAKE) -C $(INFRA) tidy
|
|
|
|
## ---- Renderer (Odin) -----------------------------------------------------
|
|
|
|
run: ## Run the native app (gui/); waits for the API to be healthy first
|
|
@API_ENV_FILE="$(API_ENV_FILE)" API_DESI_DATA="$(API_DESI_DATA)" API_BIND_ADDR="$(API_BIND_ADDR)" $(MAKE) -C $(API) run & api_pid=$$!; \
|
|
trap 'kill $$api_pid 2>/dev/null' INT TERM EXIT; \
|
|
$(MAKE) api-wait || { kill $$api_pid 2>/dev/null; exit 1; }; \
|
|
GUI_ENV_FILE="$(GUI_ENV_FILE)" $(MAKE) -C $(GUI) run; \
|
|
kill $$api_pid 2>/dev/null
|
|
|
|
build: ## Release build (gui/ + api/)
|
|
@$(MAKE) -C $(GUI) build
|
|
@$(MAKE) -C $(API) build
|
|
|
|
build-debug: ## Debug build (gui/ + api/)
|
|
@$(MAKE) -C $(GUI) build-debug
|
|
@$(MAKE) -C $(API) build
|
|
|
|
build-web: ## WebAssembly build -> build/web (gui/, needs emscripten)
|
|
@$(MAKE) -C $(GUI) build-web
|
|
|
|
run-web: ## Start WASM build + API server for web dev (waits for API health)
|
|
@API_ENV_FILE="$(API_ENV_FILE)" API_DESI_DATA="$(API_DESI_DATA)" API_BIND_ADDR="$(API_BIND_ADDR)" $(MAKE) -C $(API) run & api_pid=$$!; \
|
|
trap 'kill $$api_pid 2>/dev/null' INT TERM EXIT; \
|
|
$(MAKE) api-wait || { kill $$api_pid 2>/dev/null; exit 1; }; \
|
|
GUI_ENV_FILE="$(GUI_ENV_FILE)" $(MAKE) -C $(GUI) build-web; \
|
|
kill $$api_pid 2>/dev/null
|
|
|
|
## ---- Dev helpers ----------------------------------------------------------
|
|
|
|
api-wait: ## Poll the API health endpoint until it responds (or times out)
|
|
@echo "Waiting for API at $(API_HEALTH_URL) ..."; \
|
|
elapsed=0; \
|
|
while ! curl -sf "$(API_HEALTH_URL)" >/dev/null 2>&1; do \
|
|
elapsed=$$((elapsed + 1)); \
|
|
if [ "$${elapsed}" -ge "$(API_WAIT_TIMEOUT)" ]; then \
|
|
echo "Error: API at $(API_HEALTH_URL) not healthy after $(API_WAIT_TIMEOUT)s" >&2; \
|
|
exit 1; \
|
|
fi; \
|
|
sleep 1; \
|
|
done; \
|
|
echo "API is up."
|
|
|
|
## ---- Aggregates ----------------------------------------------------------
|
|
|
|
test: ## Test all projects (odin + cargo + go)
|
|
@$(MAKE) -C $(GUI) test
|
|
@$(MAKE) -C $(API) test
|
|
@$(MAKE) -C $(INFRA) test
|
|
|
|
clean: ## Remove build artifacts from all projects
|
|
@$(MAKE) -C $(GUI) clean
|
|
@$(MAKE) -C $(API) clean
|
|
@$(MAKE) -C $(INFRA) clean
|
|
|
|
fmt: ## Format all projects (odin + rust)
|
|
@$(MAKE) -C $(GUI) fmt
|
|
@$(MAKE) -C $(API) fmt
|
|
|
|
## ---- Passthrough to sub-project Makefiles --------------------------------
|
|
|
|
api-%: ## Forward a target to the api/ Makefile
|
|
@$(MAKE) -C $(API) $*
|
|
|
|
infra-%: ## Forward a target to the infra/ Makefile
|
|
@$(MAKE) -C $(INFRA) $*
|
|
|
|
## ---- Tooling -------------------------------------------------------------
|
|
|
|
renovate-validate: ## Validate renovate.json
|
|
bunx --package renovate renovate-config-validator renovate.json --strict
|