Makefile

tests:
	pytest --doctest-modules tests/ explainshell/ --ignore=tests/e2e --ignore=tests/regression

E2E_MANPAGES_25 := tests/e2e/manpages/ubuntu/26.04/1
E2E_MANPAGES_24 := tests/e2e/manpages/ubuntu/24.04/1
E2E_MANPAGES_ARCH := tests/e2e/manpages/arch/latest/1
E2E_DB := tests/e2e/e2e.db

e2e-db:
	rm -f $(E2E_DB)
	python -m explainshell.manager --db $(E2E_DB) extract --mode source $(E2E_MANPAGES_25)/tar.1.gz $(E2E_MANPAGES_25)/echo.1.gz $(E2E_MANPAGES_25)/grep.1.gz $(E2E_MANPAGES_24)/tar.1.gz $(E2E_MANPAGES_24)/echo.1.gz $(E2E_MANPAGES_24)/grep.1.gz $(E2E_MANPAGES_ARCH)/tar.1.gz
	python -m explainshell.manager --db $(E2E_DB) extract --mode llm:openai/gpt-5.2 $(E2E_MANPAGES_25)/git-rebase.1.gz

e2e:
	@npx playwright --version >/dev/null 2>&1 || (echo "playwright is required. Install with: npm install && npx playwright install chromium"; exit 1)
	@test -f $(E2E_DB) || (echo "e2e database not found. Build it with: make e2e-db"; exit 1)
	npx playwright test

e2e-update:
	@npx playwright --version >/dev/null 2>&1 || (echo "playwright is required. Install with: npm install && npx playwright install chromium"; exit 1)
	@test -f $(E2E_DB) || (echo "e2e database not found. Build it with: make e2e-db"; exit 1)
	npx playwright test --update-snapshots

test-llm:
	RUN_LLM_TESTS=1 pytest tests/extraction/llm/test_extractor.py::test_real_llm_echo_manpage -v

parsing-regression:
	python -m pytest tests/regression/test_parsing_regression.py -v

parsing-update:
	rm -f tests/regression/regression.db
	python -m explainshell.manager --db tests/regression/regression.db extract --mode source tests/regression/manpages/

tests-all: lint tests e2e parsing-regression

tests-quick: lint tests parsing-regression

lint:
	ruff check explainshell tests tools
	ruff format --check explainshell tests tools
	npx biome check

format:
	ruff format explainshell tests tools
	npx biome check --fix

serve:
	DB_PATH=$(or $(DB_PATH),explainshell.db) python runserver.py

db-check:
	python -m explainshell.manager --db $(or $(DB_PATH),explainshell.db) db-check

UBUNTU_ARCHIVE_DIR := manpages/ubuntu-manpages-operator
UBUNTU_ARCHIVE_OUTPUT := $(UBUNTU_ARCHIVE_DIR)/output
UBUNTU_RELEASE ?= 26.04

ubuntu-archive:
	cd $(UBUNTU_ARCHIVE_DIR) && go build -o ingest ./cmd/ingest
	MANPAGES_PUBLIC_HTML_DIR=$(UBUNTU_ARCHIVE_OUTPUT) \
	MANPAGES_RELEASES=$(UBUNTU_RELEASE) \
	MANPAGES_GZ_ONLY=true \
		$(UBUNTU_ARCHIVE_DIR)/ingest
	python tools/postprocess_ubuntu_archive.py \
		$(UBUNTU_ARCHIVE_OUTPUT)/manpages.gz/$(UBUNTU_RELEASE) \
		manpages/ubuntu/$(UBUNTU_RELEASE)

MANNED_DATA_DIR := ignore/manned

arch-archive:
	@test ! -d manpages/arch/latest || (echo "manpages/arch/latest already exists, delete it first"; exit 1)
	@test -d $(MANNED_DATA_DIR) || (echo "Manned.org dump not found. Download it first with:"; echo "  python tools/fetch_manned.py download --data-dir $(MANNED_DATA_DIR)"; exit 1)
	python tools/fetch_manned.py --log INFO extract --data-dir $(MANNED_DATA_DIR) \
		--distro arch --sections 1,1p,8 --output-dir manpages

LIVE_DB ?= explainshell.db

download-latest-db:
	tools/download-latest-db.sh $(LIVE_DB)

upload-live-db:
	tools/upload-live-db.sh $(LIVE_DB)

# Deploy to DigitalOcean App Platform from the local machine. Mirrors
# do-deploy.yml: resolves the newest db-latest asset name, renders the
# spec with envsubst (DB_NAME + GIT_SHA), applies it, then forces a
# fresh build from the current branch head. Two interactive gates:
# one for "yes, I'm deploying from local", one for a dirty working
# tree. DO_APP_ID must be set (see prod/digitalocean/app.yaml header
# for the one-time setup).
deploy-local:
	@test -n "$$DO_APP_ID" || { echo "DO_APP_ID is not set"; exit 1; }
	@printf "Deploy to production from LOCAL? [y/N] "; \
	read ans; [ "$$ans" = "y" ] || [ "$$ans" = "Y" ] || { echo "aborted"; exit 1; }
	@if [ -n "$$(git status --porcelain)" ]; then \
		echo "WARNING: working tree is dirty — you may be shipping untested changes:"; \
		git status --short; \
		printf "Continue anyway? [y/N] "; \
		read ans; [ "$$ans" = "y" ] || [ "$$ans" = "Y" ] || { echo "aborted"; exit 1; }; \
	fi
	@sha=$$(git rev-parse HEAD); \
	 if [ -n "$$(git status --porcelain)" ]; then sha="$${sha}-dirty"; fi; \
	 name=$$(gh api "repos/idank/explainshell/releases/tags/db-latest" \
	   --jq '[.assets[] | select(.name | test("^explainshell-.*\\.db\\.zst$$"))] | sort_by(.created_at) | last | .name'); \
	 tmp=$$(mktemp "$${HOME:-/tmp}/app-local.XXXXXX.yaml"); \
	 trap 'rm -f "$$tmp"' EXIT; \
	 DB_NAME="$$name" GIT_SHA="$$sha" envsubst < prod/digitalocean/app.yaml > "$$tmp"; \
	 doctl apps update "$$DO_APP_ID" --spec "$$tmp"; \
	 doctl apps create-deployment "$$DO_APP_ID" --force-rebuild --wait

.PHONY: tests e2e e2e-db e2e-update test-llm tests-all tests-quick lint serve parsing-regression parsing-update db-check ubuntu-archive arch-archive download-latest-db upload-live-db deploy-local