Makefile

.DEFAULT_GOAL := help

PLUGIN_NAME := sensei-lms
WP_ENV := COMPOSE_PROJECT_NAME=$(PLUGIN_NAME) npx @wordpress/env
NODE_MIN_VERSION := 22
WP ?= latest
PHP ?=

define check_node
	@NODE_VERSION=$$(node --version 2>/dev/null | sed 's/v//'); \
	if [ -z "$$NODE_VERSION" ]; then \
		echo "Error: Node.js is not installed. Please install Node.js $(NODE_MIN_VERSION)+ from https://nodejs.org"; \
		exit 1; \
	fi; \
	NODE_MAJOR=$$(echo "$$NODE_VERSION" | cut -d. -f1); \
	if [ "$$NODE_MAJOR" -lt "$(NODE_MIN_VERSION)" ]; then \
		echo "Error: Node.js v$$NODE_VERSION found, but $(NODE_MIN_VERSION)+ is required."; \
		echo "If using nvm: nvm install $(NODE_MIN_VERSION) && nvm use $(NODE_MIN_VERSION)"; \
		exit 1; \
	fi
endef

# Write .wp-env.override.json when WP or PHP overrides are specified.
# Resolves WP value to a wp-env core source:
#   latest  -> no override (uses .wp-env.json as-is)
#   6.8     -> WordPress/WordPress#6.8-branch (GitHub mirror)
#   7.0-beta1, 6.9-RC1 -> wordpress.org zip URL
#   nightly -> wordpress.org nightly zip
define write_override
	@if [ "$(WP)" != "latest" ] || [ -n "$(PHP)" ]; then \
		WP_VAL="$(WP)"; \
		if [ "$$WP_VAL" = "nightly" ]; then \
			WP_CORE='"https://wordpress.org/nightly-builds/wordpress-latest.zip"'; \
		elif echo "$$WP_VAL" | grep -qiE -- '-beta|-rc'; then \
			WP_CORE="\"https://wordpress.org/wordpress-$$WP_VAL.zip\""; \
		elif [ "$$WP_VAL" != "latest" ]; then \
			WP_CORE="\"WordPress/WordPress#$$WP_VAL-branch\""; \
		else \
			echo "Error: Unrecognised WP value '$$WP_VAL'"; exit 1; \
		fi; \
		( \
			printf '{\n'; \
			if [ "$(WP)" != "latest" ]; then \
				printf '  "core": %s' "$$WP_CORE"; \
				if [ -n "$(PHP)" ]; then printf ',\n'; else printf '\n'; fi; \
			fi; \
			if [ -n "$(PHP)" ]; then \
				printf '  "phpVersion": "%s"\n' "$(PHP)"; \
			fi; \
			printf '}\n'; \
		) > .wp-env.override.json; \
		echo "Override: $$(cat .wp-env.override.json | tr -d '\n')"; \
	else \
		rm -f .wp-env.override.json; \
	fi
endef

## Development environment
install: ## Install dependencies (requires Node 22+)
	$(check_node)
	npm install

install-php: ## Install PHP dependencies via wp-env (requires: make up)
	$(WP_ENV) run cli --env-cwd=wp-content/plugins/sensei composer install

up: ## Start WordPress dev environment (WP=6.8|7.0-beta1|nightly PHP=8.3)
	$(check_node)
	$(write_override)
	@if [ "$(WP)" != "latest" ] || [ -n "$(PHP)" ]; then \
		echo "Starting wp-env with WP=$(WP)$${PHP:+ PHP=$(PHP)}"; \
	else \
		echo "Starting wp-env with latest WordPress"; \
	fi
	$(WP_ENV) start --update

down: ## Stop WordPress dev environment
	-$(WP_ENV) stop
	@rm -f .wp-env.override.json

destroy: ## Remove WordPress environment containers and data
	-$(WP_ENV) destroy
	@rm -f .wp-env.override.json

logs: ## Show WordPress environment logs
	$(WP_ENV) logs

shell: ## Open a shell in the WordPress container
	$(WP_ENV) run cli bash

wp: ## Run a wp-cli command (CMD="plugin list")
	@[ -n "$(CMD)" ] || { echo "Error: CMD is required. Example: make wp CMD=\"plugin list\""; exit 1; }
	$(WP_ENV) run cli wp $(CMD)

## Testing
test-php: ## Run PHPUnit tests via wp-env (requires: make up)
	$(WP_ENV) run tests-cli --env-cwd='wp-content/plugins/sensei' vendor/bin/phpunit -c phpunit.xml

test-php-filter: ## Run targeted PHPUnit tests via wp-env (FILTER="TestClass" or FILTER="TestClass::method")
	@[ -n "$(FILTER)" ] || { echo "Error: FILTER is required. Example: make test-php-filter FILTER=\"Sensei_Quiz_Test\""; exit 1; }
	$(WP_ENV) run tests-cli --env-cwd='wp-content/plugins/sensei' vendor/bin/phpunit -c phpunit.xml --filter '$(FILTER)'

## Code quality
lint: ## Run PHPCS via the same diff-based check CI uses
	./scripts/linter-ci

psalm: ## Run Psalm static analysis under each CI PHP version (parsed from .github/workflows/psalm.yml)
	@VERSIONS=$$(grep -E "^[[:space:]]+php:[[:space:]]*\[" .github/workflows/psalm.yml | sed -E "s/.*\[(.*)\].*/\1/; s/[',]/ /g"); \
	if [ -z "$$VERSIONS" ]; then \
		echo "Error: could not parse PHP matrix from .github/workflows/psalm.yml"; exit 1; \
	fi; \
	for v in $$VERSIONS; do \
		BIN="/opt/homebrew/opt/php@$$v/bin"; \
		if [ ! -x "$$BIN/php" ]; then \
			echo "Error: PHP $$v not found at $$BIN. Install with: brew install php@$$v"; \
			exit 1; \
		fi; \
		echo "==> Psalm on PHP $$v"; \
		PATH="$$BIN:$$PATH" vendor/bin/psalm --no-cache --diff || exit $$?; \
	done

## Changelog
changelog: ## Add a changelog entry
	npm run changelog

## Build
build: ## Build plugin zip via wp-env (requires: make up)
	npm run build:assets
	rm -f assets/dist/css/jquery-ui.js
	$(WP_ENV) run cli --env-cwd=wp-content/plugins/sensei composer install --no-dev --prefer-dist --optimize-autoloader --no-scripts
	npm run archive

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

.PHONY: install install-php up down destroy logs shell wp test-php test-php-filter lint psalm changelog build help