Makefile

# Makefile for Python Portfolio
.PHONY: help install dev prod test clean lint typecheck security check docker-build docker-up docker-down docker-logs migrate seed backup create-admin generate-password reset-admin cache-bust placeholders

# Default target
help:
	@echo "Python Portfolio - Available Commands:"
	@echo ""
	@echo "  make install       - Install dependencies"
	@echo "  make dev           - Run development server (Flask + Celery)"
	@echo "  make test          - Run tests with coverage"
	@echo "  make clean         - Clean up cache files"
	@echo ""
	@echo "Quality Commands:"
	@echo "  make lint          - Run ruff linter on app/, tests/, scripts/"
	@echo "  make typecheck     - Run mypy type checker on core app modules"
	@echo "  make security      - Run bandit security scanner on app/ and scripts/"
	@echo "  make check         - Run lint + typecheck + security (full quality gate)"
	@echo ""
	@echo "Docker Commands:"
	@echo "  make docker-build  - Build Docker images"
	@echo "  make docker-up     - Start all services (Flask + Celery + Redis)"
	@echo "  make docker-down   - Stop all services"
	@echo "  make docker-logs   - View logs"
	@echo "  make docker-shell  - Open shell in web container"
	@echo ""
	@echo "Database Commands:"
	@echo "  make migrate       - Run database migrations"
	@echo "  make seed          - Seed database with sample data"
	@echo "  make backup        - Backup database"
	@echo "  make restore       - Restore database from backup"
	@echo "  make list-backups  - List available backups"
	@echo "  make create-admin  - Create admin user"
	@echo "  make generate-password - Generate admin password hash"
	@echo "  make reset-admin   - Reset admin credentials in .env"
	@echo "  make cache-bust    - Generate static asset manifest"
	@echo "  make placeholders  - Generate placeholder images"
	@echo ""

# Install dependencies
install:
	pip install -r requirements.txt

# Run development servers (Flask + Celery)
dev:
	@echo "Starting Redis (make sure Redis is running)..."
	@echo "Starting Celery worker in background..."
	start /B celery -A app.celery_config.celery worker --loglevel=info --pool=solo
	@echo "Starting Flask development server..."
	python wsgi.py

# Run tests
test:
	pytest tests/ -v --cov=. --cov-report=html --cov-report=term-missing

# Clean cache and temporary files
clean:
	@echo "Cleaning cache files..."
	del /S /Q *.pyc 2>nul
	rmdir /S /Q __pycache__ 2>nul
	rmdir /S /Q .pytest_cache 2>nul
	rmdir /S /Q htmlcov 2>nul
	rmdir /S /Q .coverage 2>nul
	@echo "Clean complete!"

# Code quality targets
lint:
	python -m ruff check app/ tests/ scripts/ wsgi.py

typecheck:
	python -m mypy app/models.py app/app.py app/admin_routes.py

security:
	bandit -r app/ scripts/ -ll -i

check: lint typecheck security

# Docker commands
docker-build:
	docker-compose build

docker-up:
	@echo "Starting Docker services..."
	docker-compose up -d
	@echo "Services started! Access at http://localhost:5000"
	@echo "View logs with: make docker-logs"
	@echo "💡 TIP: Backup database manually with: make backup"

docker-down:
	docker-compose down

docker-logs:
	docker-compose logs -f

docker-shell:
	docker-compose exec web /bin/bash

# Database commands
migrate:
	python scripts/migrate_to_new_schema.py

seed:
	python -c "from scripts.migrate_to_new_schema import seed_sample_data; seed_sample_data()"

backup:
	@echo "Creating database backup..."
	@echo "Note: Use PowerShell command for Windows - see README.md"
	@echo "PowerShell: Copy-Item instance/portfolio.db backups/backup_$$(Get-Date -Format 'yyyyMMdd_HHmmss').db"

restore:
	@echo "Available backups:"
	@echo "Use PowerShell to restore:"
	@echo "Copy-Item backups/[filename].db instance/portfolio.db -Force"
	@echo ""
	@echo "List backups: Get-ChildItem backups/*.db"

list-backups:
	@echo "Use PowerShell command:"
	@echo "Get-ChildItem backups/*.db | Sort-Object LastWriteTime -Descending"

create-admin:
	python -c "from app.models import db, User; from app import app; \
	with app.app_context(): \
		username = input('Username: '); \
		email = input('Email: '); \
		password = input('Password: '); \
		user = User(username=username, email=email, is_superuser=True); \
		user.set_password(password); \
		db.session.add(user); \
		db.session.commit(); \
		print(f'Admin user {username} created!')"

generate-password:
	python scripts/generate_password.py

reset-admin:
	python scripts/reset_password_to_default.py

cache-bust:
	python scripts/cache_buster.py > static_manifest.json

placeholders:
	python scripts/generate_placeholders.py

# Production deployment
prod:
	@echo "Starting production server with Waitress..."
	waitress-serve --host=0.0.0.0 --port=5000 --threads=4 wsgi:app