Makefile

.PHONY: all help setup setup-latest clean build build-latest check check-latest upload upload-latest test run-local docker-build docker-run docker-stop docker-logs test-deps test-compatibility release-build release-all release-publish update-requirements

# Default Python command
PYTHON ?= python
# Package management tool (uv preferred if available)
HAS_UV := $(shell command -v uv 2> /dev/null)
ifdef HAS_UV
    PKG_MANAGER = uv
    PIP_INSTALL = uv pip install
    SYNC = uv sync
else
    PKG_MANAGER = pip
    PIP_INSTALL = pip install
    SYNC = pip install -r
endif

# Docker settings
DOCKER_IMAGE ?= mcp_tavily
DOCKER_CONTAINER ?= mcp_tavily_container
HOST_PORT ?= 8000
CONTAINER_PORT ?= 8000

# Default target
all: clean setup build check

# Set up the development environment
setup:
	@echo "Setting up development environment..."
	@if [ ! -d ".venv" ]; then \
		$(PYTHON) -m venv .venv; \
		. .venv/bin/activate; \
	fi
	@. .venv/bin/activate && $(PIP_INSTALL) --upgrade pip
	@. .venv/bin/activate && $(PIP_INSTALL) setuptools==67.8.0 wheel build twine
ifdef HAS_UV
	@. .venv/bin/activate && $(SYNC) --dev
else
	@. .venv/bin/activate && $(SYNC) requirements-dev.txt
	@. .venv/bin/activate && $(SYNC) requirements.txt
endif
	@. .venv/bin/activate && $(PIP_INSTALL) -e .
	@echo "Setup complete!"

# Set up development environment with latest dependencies
setup-latest:
	@echo "Setting up development environment with latest dependencies..."
	@if [ ! -d ".venv" ]; then \
		$(PYTHON) -m venv .venv; \
		. .venv/bin/activate; \
	fi
	@. .venv/bin/activate && $(PIP_INSTALL) --upgrade pip
	@. .venv/bin/activate && $(PIP_INSTALL) setuptools==67.8.0 wheel build twine
	@. .venv/bin/activate && $(PIP_INSTALL) -r requirements-dev.txt -U
	@. .venv/bin/activate && $(PIP_INSTALL) -e .
	@echo "Setup with latest dependencies complete!"

# Clean build artifacts
clean:
	@echo "Cleaning build artifacts..."
	@rm -rf dist/ build/ src/*.egg-info/
	@find . -type d -name __pycache__ -exec rm -rf {} +
	@find . -type f -name "*.pyc" -delete
	@echo "Clean complete!"

# Build the package (ensure virtualenv is set up)
build: setup clean
	@echo "Building package..."
	@. .venv/bin/activate && $(PIP_INSTALL) build
	@. .venv/bin/activate && $(PYTHON) -m build
	@echo "Build complete!"

# Build with latest dependencies
build-latest: setup-latest clean
	@echo "Building package with latest dependencies..."
	@. .venv/bin/activate && $(PIP_INSTALL) build
	@. .venv/bin/activate && $(PYTHON) -m build
	@echo "Build with latest dependencies complete!"

# Check the distribution with twine
check: build
	@echo "Checking distribution with twine..."
	@. .venv/bin/activate && $(PIP_INSTALL) twine
	@. .venv/bin/activate && twine check dist/*
	@echo "Check complete!"

# Check the distribution with twine (with latest dependencies)
check-latest: build-latest
	@echo "Checking distribution with twine (latest deps)..."
	@. .venv/bin/activate && $(PIP_INSTALL) twine
	@. .venv/bin/activate && twine check dist/*
	@echo "Check complete!"

# Upload to PyPI
upload: check
	@echo "Uploading to PyPI..."
	@. .venv/bin/activate && twine upload dist/*
	@echo "Upload complete!"

# Upload to PyPI (assumes package already built and checked)
upload-latest:
	@echo "Uploading to PyPI (using existing dist files)..."
	@if [ ! -d "dist" ] || [ -z "$$(ls -A dist/ 2>/dev/null)" ]; then \
		echo "Error: No distribution files found in dist/. Run 'make release-all' first."; \
		exit 1; \
	fi
	@. .venv/bin/activate && $(PIP_INSTALL) twine
	@. .venv/bin/activate && twine upload dist/*
	@echo "Upload complete!"

# Run tests (ensure virtualenv is set up)
test: setup
	@echo "Running tests..."
	@./tests/run_tests.sh
	@echo "Tests complete!"

# Test with updated dependencies
test-deps: setup
	@echo "Testing with latest dependencies..."
	@. .venv/bin/activate && uv pip install -r requirements-dev.txt -U
	@. .venv/bin/activate && python -W ignore -m pytest tests --cov=src/mcp_server_tavily --cov-report=term
	@echo "Dependency compatibility test complete!"

# Full compatibility test - update deps and run all tests
test-compatibility: setup
	@echo "Running full compatibility test with latest dependencies..."
	@. .venv/bin/activate && uv pip install -r requirements-dev.txt -U
	@. .venv/bin/activate && python -W ignore -m pytest tests --cov=src/mcp_server_tavily --cov-report=term --verbose
	@echo "Full compatibility test complete!"

# Build for release with latest dependencies and full testing
release-build: clean setup-latest
	@echo "Preparing release build with latest dependencies..."
	@. .venv/bin/activate && python -W ignore -m pytest tests --cov=src/mcp_server_tavily --cov-report=term
	@echo "All tests passed! Building package..."
	@. .venv/bin/activate && $(PIP_INSTALL) build
	@. .venv/bin/activate && $(PYTHON) -m build
	@echo "Release build complete!"

# Complete release workflow: test, build, and check with latest dependencies
release-all: clean setup-latest
	@echo "Running complete release workflow with latest dependencies..."
	@. .venv/bin/activate && python -W ignore -m pytest tests --cov=src/mcp_server_tavily --cov-report=term
	@echo "All tests passed! Building package..."
	@. .venv/bin/activate && $(PIP_INSTALL) build twine
	@. .venv/bin/activate && $(PYTHON) -m build
	@echo "Checking distribution with twine..."
	@. .venv/bin/activate && twine check dist/*
	@echo "Release workflow complete! Ready to upload with 'make upload-latest'"

# Complete release workflow including upload
release-publish: clean setup-latest
	@echo "Running complete release and publish workflow..."
	@. .venv/bin/activate && python -W ignore -m pytest tests --cov=src/mcp_server_tavily --cov-report=term
	@echo "All tests passed! Building package..."
	@. .venv/bin/activate && $(PIP_INSTALL) build twine
	@. .venv/bin/activate && $(PYTHON) -m build
	@echo "Checking distribution with twine..."
	@. .venv/bin/activate && twine check dist/*
	@echo "Uploading to PyPI..."
	@. .venv/bin/activate && twine upload dist/*
	@echo "Release published successfully!"

# Update requirements files with latest compatible versions
update-requirements: setup-latest
	@echo "Updating requirements files with latest compatible versions..."
	@. .venv/bin/activate && python -W ignore -m pytest tests --cov=src/mcp_server_tavily --cov-report=term
	@echo "Tests passed with latest versions! Updating requirements files..."
	@. .venv/bin/activate && pip freeze | grep -E "(mcp|pydantic|python-dotenv|tavily)" > requirements-new.txt
	@. .venv/bin/activate && pip freeze | grep -E "(pytest|build|twine|wheel|setuptools)" > requirements-dev-new.txt
	@echo "New requirements saved to requirements-new.txt and requirements-dev-new.txt"
	@echo "Review and replace the original files if satisfied with the versions."

help:
	@echo "Available targets:"
	@echo "  setup   - Set up development environment"
	@echo "  clean   - Clean build artifacts"
	@echo "  build   - Build the package"
	@echo "  check   - Check the distribution with twine"
	@echo "  upload  - Upload to PyPI (requires PyPI credentials)"
	@echo "  test    - Run tests"
	@echo "  test-deps - Test with latest dependency updates"
	@echo "  test-compatibility - Full compatibility test with updated dependencies"
	@echo "  setup-latest - Set up development environment with latest dependencies"
	@echo "  build-latest - Build package with latest dependencies"
	@echo "  release-build - Build for release with latest deps and full testing"
	@echo "  release-all - Complete release workflow (test, build, check) with latest deps"
	@echo "  release-publish - Complete release and publish workflow (includes upload)"
	@echo "  upload-latest - Upload existing dist files without rebuilding/downgrading"
	@echo "  update-requirements - Update requirements files with latest compatible versions"
	@echo "  all     - Run clean, setup, build, and check (default)"
	@echo "  run-local    - Run the MCP Tavily server locally (in .venv)"
	@echo "  docker-build - Build Docker image ($(DOCKER_IMAGE))"
	@echo "  docker-run   - Run Docker container ($(DOCKER_CONTAINER)) (detached, ports $(HOST_PORT):$(CONTAINER_PORT))"
	@echo "  docker-stop  - Stop and remove Docker container"
	@echo "  docker-logs  - Follow Docker container logs"
run-local:
	@echo "Running MCP Tavily server locally..."
	@. .venv/bin/activate && python -m mcp_server_tavily
docker-build:
	@echo "Building Docker image '$(DOCKER_IMAGE)'..."
	@docker build -t $(DOCKER_IMAGE) .
docker-run:
	@echo "Running Docker container '$(DOCKER_CONTAINER)' (detached)..."
	@docker run -d --name $(DOCKER_CONTAINER) -e TAVILY_API_KEY=$$TAVILY_API_KEY -p $(HOST_PORT):$(CONTAINER_PORT) $(DOCKER_IMAGE)
docker-stop:
	@echo "Stopping and removing Docker container '$(DOCKER_CONTAINER)'..."
	@docker stop $(DOCKER_CONTAINER) || true
	@docker rm $(DOCKER_CONTAINER) || true
docker-logs:
	@echo "Following logs for Docker container '$(DOCKER_CONTAINER)'..."
	@docker logs -f $(DOCKER_CONTAINER)