Makefile

# Project information
PROJECT_NAME := redoc
PACKAGE_NAME := redoc
PYTHON := python3
PIP := pip
POETRY := $(shell command -v poetry 2> /dev/null || echo "poetry")

# Source directory
SRC_DIR := src/redoc
CORE_DIR := $(SRC_DIR)/core

# Environment
PYTHON_ENV := .venv
PYTHON_BIN := $(PYTHON_ENV)/bin/python
PIP := $(PYTHON_ENV)/bin/pip

# Development
DEV_PORT := 8000
TEST_PATH := tests
COVERAGE_REPORT := htmlcov
DOCKER_COMPOSE := docker-compose

# Colors
GREEN  := $(shell tput -Txterm setaf 2)
YELLOW := $(shell tput -Txterm setaf 3)
WHITE  := $(shell tput -Txterm setaf 7)
RESET  := $(shell tput -Txterm sgr0)

# Documentation
DOCS_PORT := 8001
DOCS_DIR := docs
BUILD_DIR := build
DIST_DIR := dist

# Python source files
PYTHON_SRC := $(shell find $(SRC_DIR) -type f -name '*.py')
PYTHON_TESTS := $(shell find $(TEST_PATH) -type f -name '*.py')

# Default target
.DEFAULT_GOAL := help

.PHONY: help
help:  ## Display this help
	@echo "$(YELLOW)$(PROJECT_NAME) - Makefile$(RESET)"
	@echo "\n$(WHITE)Usage: make $(GREEN)<target>$(RESET)"
	@echo "\n$(YELLOW)Available targets:$(RESET)"
	@awk 'BEGIN {FS = ":.*?##"} /^[a-zA-Z_-]+:.*?##/ { printf "  $(GREEN)%-20s$(RESET) %s\n", $$1, $$2 }' $(MAKEFILE_LIST) | sort
	@echo "\nRun 'make <target>' where target is one of the above."

##@ Setup
install:  ## Install package in development mode with all dependencies
	@echo "$(YELLOW)Installing package in development mode...$(RESET)"
	$(PYTHON) -m pip install --upgrade pip
	$(PYTHON) -m pip install -U poetry
	$(POETRY) install --with dev --extras "cli server"
	@echo "$(GREEN)✓ Package installed in development mode$(RESET)"

install-dev:  ## Install development dependencies
	@echo "$(YELLOW)Installing development dependencies...$(RESET)"
	$(POETRY) install --with dev
	@echo "$(GREEN)✓ Development dependencies installed$(RESET)"

install-hooks:  ## Install git hooks
	@echo "$(YELLOW)Installing pre-commit hooks...$(RESET)"
	$(POETRY) run pre-commit install
	@echo "$(GREEN)✓ Pre-commit hooks installed$(RESET)"

install-deps:  ## Install runtime dependencies
	@echo "$(YELLOW)Installing runtime dependencies...$(RESET)"
	$(POETRY) install --extras "cli"
	@echo "$(GREEN)✓ Runtime dependencies installed$(RESET)"

install-server:  ## Install server dependencies
	@echo "$(YELLOW)Installing server dependencies...$(RESET)"
	$(POETRY) install --extras "server"
	@echo "$(GREEN)✓ Server dependencies installed$(RESET)"

install-js:  ## Install JavaScript dependencies
	@echo "$(YELLOW)Installing JavaScript dependencies...$(RESET)
	npm install
	@echo "$(GREEN)✓ JavaScript dependencies installed$(RESET)"

install-deps: install-python install-js  ## Install all dependencies

check-env:  ## Check environment configuration
	@echo "$(YELLOW)Checking environment configuration...$(RESET)
	@if [ ! -f .env ]; then \
		echo "$(YELLOW)Warning: .env file not found. Creating from example...$(RESET)"; \
		cp -n .env.example .env; \
	fi
	@echo "$(GREEN)✓ Environment configuration checked$(RESET)"

##@ Run targets
start: start-dev  ## Alias for start-dev

start-dev: check-env  ## Start development server
	@echo "$(YELLOW)Starting development server...$(RESET)"
	@$(POETRY) run uvicorn redoc.api:app --reload --port $(DEV_PORT)


start-ollama:  ## Start Ollama server (required for local development)
	@echo "$(YELLOW)Starting Ollama server...$(RESET)
	@echo "$(YELLOW)Note: Keep this running in a separate terminal$(RESET)"
	ollama serve

run-example:  ## Run the example script
	@echo "$(YELLOW)Running example...$(RESET)"
	$(POETRY) run python -m redoc.redoc

start-prod: check-env  ## Start production server
	@echo "$(YELLOW)Starting production server on port $(PROD_PORT)...$(RESET)"
	@$(POETRY) run uvicorn redoc.api:app --host 0.0.0.0 --port $(PROD_PORT)

start-docker:  ## Start using Docker
	@echo "$(YELLOW)Starting with Docker...$(RESET)"
	@$(DOCKER_COMPOSE) up --build

##@ Test & Lint
test:  ## Run tests
	@echo "$(YELLOW)Running tests...$(RESET)"
	$(POETRY) run pytest $(TEST_PATH) -v

test-cov:  ## Run tests with coverage
	@echo "$(YELLOW)Running tests with coverage...$(RESET)"
	$(POETRY) run pytest --cov=$(SRC_DIR) --cov-report=term-missing --cov-report=html $(TEST_PATH) -v

lint:  ## Run all linters
	@echo "$(YELLOW)Running linters...$(RESET)"
	$(POETRY) run black --check $(SRC_DIR) $(TEST_PATH)
	$(POETRY) run flake8 $(SRC_DIR) $(TEST_PATH)
	$(POETRY) run mypy $(SRC_DIR) $(TEST_PATH)

format:  ## Format code
	@echo "$(YELLOW)Formatting code...$(RESET)"
	$(POETRY) run black $(SRC_DIR) $(TEST_PATH)
	$(POETRY) run isort $(SRC_DIR) $(TEST_PATH)

check: lint test  ## Run all checks (lint and test)

##@ Build
build:  ## Build package
	@echo "$(YELLOW)Building package...$(RESET)"
	$(POETRY) version patch
	$(POETRY) build
	@echo "$(GREEN)✓ Package built in dist/$(RESET)"

##@ Publish
publish: build  ## Publish package to PyPI
	@echo "$(YELLOW)Publishing to PyPI...$(RESET)"
	$(POETRY) publish

##@ Cleanup
clean:  ## Remove build and test artifacts
	@echo "$(YELLOW)Cleaning up...$(RESET)"
	@# Python
	@find . -name '*.pyc' -exec rm -f {} +
	@find . -name '*.pyo' -exec rm -f {} +
	@find . -name '*~' -exec rm -f {} +
	@find . -name '__pycache__' -exec rm -fr {} +
	@find . -name '.pytest_cache' -exec rm -fr {} +
	@rm -f .coverage coverage.xml
	@rm -rf $(COVERAGE_REPORT)
	# Build artifacts
	@rm -rf $(BUILD_DIR) $(DIST_DIR) *.egg-info
	@echo "$(GREEN)✓ Clean complete$(RESET)

clean-all: clean  ## Remove all artifacts including virtualenvs
	@echo "$(YELLOW)Removing virtual environments...$(RESET)"
	@rm -rf $(PYTHON_ENV) .venv/
	@echo "$(GREEN)✓ All clean!$(RESET)"

clean-node:  ## Remove node_modules
	@echo "$(YELLOW)Cleaning node modules...$(RESET)"
	@rm -rf $(NODE_MODULES) 2>/dev/null || true
	@rm -f package-lock.json 2>/dev/null || true

clean-docker:  ## Stop and remove Docker containers and volumes
	@echo "$(YELLOW)Cleaning Docker containers and volumes...$(RESET)"
	@if command -v docker-compose >/dev/null 2>&1; then \
		docker-compose down -v --remove-orphans || true; \
	else \
		echo "$(YELLOW)Docker Compose not found, skipping...$(RESET)"; \
	fi

##@ Documentation
docs:  ## Generate documentation
	@echo "$(YELLOW)Generating documentation...$(RESET)"
	@$(POETRY) run mkdocs build

serve-docs:  ## Serve documentation locally
	@echo "$(YELLOW)Serving documentation at http://localhost:$(DOCS_PORT)$(RESET)"
	@$(POETRY) run mkdocs serve -a 127.0.0.1:$(DOCS_PORT)

update-docs:  ## Update API documentation
	@echo "$(YELLOW)Updating API documentation...$(RESET)"
	@$(POETRY) run mkdocs build --clean
	@echo "$(GREEN)✓ Documentation updated$(RESET)"


##@ Docker
docker-up:  ## Start Docker containers
	@echo "$(YELLOW)Starting Docker containers...$(NC)"
	@$(DOCKER_COMPOSE) up -d

docker-down:  ## Stop Docker containers
	@echo "$(YELLOW)Stopping Docker containers...$(NC)"
	@$(DOCKER_COMPOSE) down

docker-logs:  ## Show Docker logs
	@echo "$(YELLOW)Showing Docker logs...$(NC)"
	@$(DOCKER_COMPOSE) logs -f

##@ Cleanup
clean:  ## Clean build artifacts
	@echo "$(YELLOW)Cleaning build artifacts...$(RESET)"
	@rm -rf build/ dist/ *.egg-info/ htmlcov/ .coverage .pytest_cache/
	@find . -name '*.pyc' -delete
	@find . -name '__pycache__' -delete

clean-docs:  ## Clean documentation build
	@echo "$(YELLOW)Cleaning documentation...$(RESET)"
	@rm -rf site/

clean-all: clean clean-docs  ## Clean everything
	@echo "$(YELLOW)Cleaning everything...$(RESET)"
	@rm -rf .mypy_cache/ .pytest_cache/ .coverage htmlcov/
	@find . -name '*.pyc' -delete -o -name '__pycache__' -delete -o -name '.pytest_cache' -delete
	@echo "$(GREEN)✓ All clean!$(RESET)"
	@echo "$(GREEN)✓ Clean complete$(NC)"

clean-all: clean  ## Clean everything (including Docker)
	@echo "$(YELLOW)Cleaning Docker containers and volumes...$(NC)"
	@$(DOCKER_COMPOSE) down -v --remove-orphans
	@echo "$(GREEN)✓ All clean!$(NC)"

##@ Help
help:  ## Show this help message
	@awk 'BEGIN {FS = ":.*##"; printf "\n$(YELLOW)Usage:$(NC)\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_-]+:.*?##/ { printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)

##@ Phony Targets
.PHONY: setup-env install install-dev test test-cov lint format docs serve-docs \
        build publish docker-up docker-down docker-logs clean clean-all help
publish: build
	$(POETRY) publish

# Generate documentation
docs:
	@echo "Generating documentation..."
	@mkdir -p docs
	$(POETRY) run sphinx-apidoc -o docs/source $(PACKAGE_NAME)
	$(POETRY) run sphinx-build -b html docs/source docs/build

# Generate portfolio
portfolio:
	$(POETRY) run python -m $(PACKAGE_NAME).cli generate-portfolio

# Initialize git repository
git-init:
	git init
	git add .
	git commit -m "Initial commit"