# Makefile for karaoke-gen project # Run `make help` to see available commands .PHONY: help install install-backend install-frontend build-frontend dev-install test test-unit test-backend test-e2e test-frontend test-all lint clean emulators-start emulators-stop local-stack-up local-stack-down test-local-stack eval-custom-lyrics # Per-stage timeout in seconds (default: 10 minutes) # Prevents hangs from stale dev servers, broken emulators, etc. # Override with: make test TEST_TIMEOUT=300 TEST_TIMEOUT ?= 600 # Default target help: @echo "Available commands:" @echo " make test - Run ALL tests (backend + frontend, installs deps automatically)" @echo " make test-backend - Run backend tests only (unit + emulator)" @echo " make test-frontend - Run frontend unit tests (Jest)" @echo " make test-frontend-e2e - Run frontend E2E tests (Playwright, requires dev server)" @echo " make test-unit - Run unit tests only (karaoke_gen package)" @echo " make test-e2e - Run emulator tests with auto-start/stop" @echo " make install - Install all dependencies (backend + frontend)" @echo " make build-frontend - Build frontend and copy to Python package" @echo " make dev-install - Build frontend + pip install -e . (for local CLI testing)" @echo " make lint - Run linter checks" @echo " make emulators-start - Start GCP emulators for local development" @echo " make emulators-stop - Stop GCP emulators" @echo "" @echo "Before committing, run: make test" # Install dependencies (only if needed) install-backend: @if [ ! -d "$$(poetry env info --path 2>/dev/null)" ] || ! poetry run python -c "import fastapi" 2>/dev/null; then \ echo "=== Installing backend dependencies ==="; \ poetry install; \ fi install-frontend: @if [ ! -d "frontend/node_modules" ]; then \ echo "=== Installing frontend dependencies ==="; \ cd frontend && npm install; \ fi install: install-backend install-frontend # Build frontend and copy to Python package build-frontend: install-frontend @echo "=== Building frontend ===" cd frontend && npm run build @echo "=== Copying build to Python package ===" rm -rf karaoke_gen/nextjs_frontend/out mkdir -p karaoke_gen/nextjs_frontend/out cp -r frontend/out/* karaoke_gen/nextjs_frontend/out/ @# Drop Next.js RSC payloads (*.txt, ~66 MB across 33 locales): the CLI review @# server never serves them (only HTML entrypoints, /_next and /static), and they @# pushed the wheel past PyPI's 100 MiB per-file limit (2026-10-27..29). find karaoke_gen/nextjs_frontend/out -name '*.txt' -type f -delete @echo "✅ Frontend built and copied to karaoke_gen/nextjs_frontend/out/" # Build frontend + install package in editable mode for local CLI testing # After running this, `karaoke-gen` CLI will use the freshly built frontend. dev-install: build-frontend @echo "=== Installing package in editable mode ===" pip install -e . @echo "" @echo "✅ Ready! You can now run karaoke-gen with the updated frontend." @echo " Example: karaoke-gen input.flac \"Artist\" \"Title\"" # Run unit tests for karaoke_gen package test-unit: install-backend @echo "=== Running karaoke_gen unit tests ===" timeout $(TEST_TIMEOUT) poetry run pytest tests/unit/ -v --cov=karaoke_gen --cov-report=term-missing --cov-fail-under=69 # Run backend unit tests (excludes emulator tests) test-backend-unit: install-backend @echo "=== Running backend unit tests ===" timeout $(TEST_TIMEOUT) poetry run pytest backend/tests/ --ignore=backend/tests/emulator -v # Run E2E integration tests with emulators test-e2e: install-backend @echo "=== Running E2E integration tests with emulators ===" @./scripts/start-emulators.sh || (echo "Failed to start emulators" && exit 1) @export FIRESTORE_EMULATOR_HOST=127.0.0.1:8080 && \ export STORAGE_EMULATOR_HOST=http://127.0.0.1:4443 && \ export GOOGLE_CLOUD_PROJECT=test-project && \ export GCS_BUCKET_NAME=test-bucket && \ export ADMIN_TOKENS=test-admin-token && \ export ENVIRONMENT=test && \ timeout $(TEST_TIMEOUT) poetry run pytest backend/tests/emulator/ -v; \ TEST_RESULT=$$?; \ ./scripts/stop-emulators.sh; \ exit $$TEST_RESULT # Run all backend tests (unit + emulator) test-backend: test-unit test-backend-unit test-e2e @echo "" @echo "✅ Backend tests passed!" # Run frontend unit tests (Jest only - E2E requires manual setup) test-frontend: install-frontend @echo "=== Running frontend unit tests ===" cd frontend && timeout $(TEST_TIMEOUT) npm run test:unit # Run frontend E2E tests (requires dev server - run manually, not in make test) test-frontend-e2e: install-frontend @echo "=== Running frontend E2E tests ===" cd frontend && timeout $(TEST_TIMEOUT) npm run test:e2e # Run ALL tests (backend + frontend) - use this before committing! test: test-backend test-frontend @echo "" @echo "✅ All tests passed! Ready to commit." # Alias for test test-all: test # Lint checks lint: @echo "=== Running lint checks ===" poetry run ruff check karaoke_gen/ backend/ poetry run ruff format --check karaoke_gen/ backend/ # Start emulators for local development emulators-start: @echo "=== Starting GCP emulators ===" ./scripts/start-emulators.sh # Stop emulators emulators-stop: @echo "=== Stopping GCP emulators ===" ./scripts/stop-emulators.sh # Local E2E stack: real backend on emulators + fake workers (see docs/TESTING.md) local-stack-up: ./scripts/local-stack.sh up --frontend local-stack-down: ./scripts/local-stack.sh down # Full-journey Playwright suite against the local stack (starts it if needed) test-local-stack: install-frontend cd frontend && timeout $(TEST_TIMEOUT) npm run test:e2e:local-stack # Clean up temporary files clean: 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 ".coverage" -exec rm -rf {} + 2>/dev/null || true find . -type f -name "*.pyc" -delete 2>/dev/null || true rm -rf htmlcov/ .coverage coverage.xml 2>/dev/null || true @echo "Cleaned up temporary files" .PHONY: eval-custom-lyrics eval-custom-lyrics: cd backend && poetry run python -m backend.eval.custom_lyrics.run