python-sdk/Makefile

.DEFAULT_GOAL := help
SHELL := /bin/bash
.PHONY: help setup install-python venv deps test lint format build clean publish-all

# Colors for output
CYAN := \033[0;36m
GREEN := \033[0;32m
RED := \033[0;31m
YELLOW := \033[0;33m
NC := \033[0m # No Color

# Python version
PYTHON_VERSION := 3.12

help: ## Show this help message
	@echo -e "$(CYAN)Hanzo Python SDK Monorepo Makefile$(NC)"
	@echo -e "$(YELLOW)Usage:$(NC) make [target]"
	@echo
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  $(GREEN)%-20s$(NC) %s\n", $$1, $$2}'

setup: install-python venv deps ## Complete setup: install Python, create venv, install deps

install-python: ## Install Python using uv
	@echo -e "$(CYAN)Installing Python $(PYTHON_VERSION)...$(NC)"
	@if ! command -v uv &> /dev/null; then \
		echo -e "$(RED)Error: uv is not installed. Please install it first.$(NC)"; \
		echo "Run: curl -LsSf https://astral.sh/uv/install.sh | sh"; \
		exit 1; \
	fi
	@uv python install $(PYTHON_VERSION)
	@echo -e "$(GREEN)Python $(PYTHON_VERSION) installed successfully$(NC)"

venv: ## Create virtual environment
	@echo -e "$(CYAN)Creating virtual environment...$(NC)"
	@uv venv --python $(PYTHON_VERSION)
	@echo -e "$(GREEN)Virtual environment created$(NC)"
	@echo -e "$(YELLOW)Activate with: source .venv/bin/activate$(NC)"

deps: ## Install all dependencies for all packages
	@echo -e "$(CYAN)Installing dependencies...$(NC)"
	@source .venv/bin/activate && uv pip install -e .
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-agents
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-mcp
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-cli
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-repl
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-memory
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-network
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-mcp-client
	@source .venv/bin/activate && uv pip install -e ./pkg/hanzo-aci
	@echo -e "$(GREEN)All dependencies installed$(NC)"

dev-deps: ## Install development dependencies
	@echo -e "$(CYAN)Installing development dependencies...$(NC)"
	@source .venv/bin/activate && uv pip install pytest pytest-asyncio mypy ruff black coverage
	@echo -e "$(GREEN)Development dependencies installed$(NC)"

test: ## Run tests for all packages
	@echo -e "$(CYAN)Running tests...$(NC)"
	@source .venv/bin/activate && python -m pytest tests/ -v
	@source .venv/bin/activate && cd pkg/hanzo-agents && python -m pytest tests/ -v || true
	@source .venv/bin/activate && cd pkg/hanzo-mcp && python -m pytest tests/ -v || true
	@source .venv/bin/activate && cd pkg/hanzo-memory && python -m pytest tests/ -v || true
	@source .venv/bin/activate && cd pkg/hanzo-aci && python -m pytest tests/ -v || true
	@echo -e "$(GREEN)Tests completed$(NC)"

lint: ## Run linting for all packages
	@echo -e "$(CYAN)Running linters...$(NC)"
	@source .venv/bin/activate && ruff check . --fix
	@source .venv/bin/activate && mypy . --ignore-missing-imports || true
	@echo -e "$(GREEN)Linting completed$(NC)"

format: ## Format code for all packages
	@echo -e "$(CYAN)Formatting code...$(NC)"
	@source .venv/bin/activate && ruff format .
	@source .venv/bin/activate && black . || true
	@echo -e "$(GREEN)Formatting completed$(NC)"

build: ## Build all packages
	@echo -e "$(CYAN)Building packages...$(NC)"
	@source .venv/bin/activate && python -m build .
	@source .venv/bin/activate && cd pkg/hanzo-agents && python -m build
	@source .venv/bin/activate && cd pkg/hanzo-mcp && python -m build
	@source .venv/bin/activate && cd pkg/hanzo-cli && python -m build
	@source .venv/bin/activate && cd pkg/hanzo-repl && python -m build
	@source .venv/bin/activate && cd pkg/hanzo-memory && python -m build
	@source .venv/bin/activate && cd pkg/hanzo-network && python -m build
	@source .venv/bin/activate && cd pkg/hanzo-mcp-client && python -m build
	@source .venv/bin/activate && cd pkg/hanzo-aci && python -m build
	@echo -e "$(GREEN)All packages built$(NC)"

clean: ## Clean build artifacts
	@echo -e "$(CYAN)Cleaning build artifacts...$(NC)"
	@find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
	@find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
	@find . -type d -name "dist" -exec rm -rf {} + 2>/dev/null || true
	@find . -type d -name "build" -exec rm -rf {} + 2>/dev/null || true
	@find . -type d -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
	@find . -type d -name ".mypy_cache" -exec rm -rf {} + 2>/dev/null || true
	@find . -type d -name ".ruff_cache" -exec rm -rf {} + 2>/dev/null || true
	@find . -type f -name "*.pyc" -delete 2>/dev/null || true
	@find . -type f -name "*.pyo" -delete 2>/dev/null || true
	@find . -type f -name ".coverage" -delete 2>/dev/null || true
	@rm -rf htmlcov/ 2>/dev/null || true
	@echo -e "$(GREEN)Clean completed$(NC)"

publish-check: ## Check if packages are ready to publish
	@echo -e "$(CYAN)Checking package configurations...$(NC)"
	@python scripts/check_packages.py

publish-all: build ## Publish all packages to PyPI
	@echo -e "$(CYAN)Publishing packages to PyPI...$(NC)"
	@echo -e "$(YELLOW)Warning: This will publish to PyPI. Make sure you have the correct credentials.$(NC)"
	@read -p "Continue? [y/N] " -n 1 -r; echo; \
	if [[ $$REPLY =~ ^[Yy]$$ ]]; then \
		$(MAKE) publish-hanzoai; \
		$(MAKE) publish-hanzo-agents; \
		$(MAKE) publish-hanzo-mcp; \
		$(MAKE) publish-hanzo-cli; \
		$(MAKE) publish-hanzo; \
		$(MAKE) publish-hanzo-repl; \
		$(MAKE) publish-hanzo-memory; \
		$(MAKE) publish-hanzo-network; \
		$(MAKE) publish-hanzo-mcp-client; \
		$(MAKE) publish-hanzo-aci; \
	else \
		echo -e "$(RED)Publishing cancelled$(NC)"; \
	fi

# Publishing individual packages
publish-hanzoai: ## Publish hanzoai package
	@echo -e "$(CYAN)Publishing hanzoai...$(NC)"
	@cd . && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-agents: ## Publish hanzo-agents package  
	@echo -e "$(CYAN)Publishing hanzo-agents...$(NC)"
	@cd pkg/hanzo-agents && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-mcp: ## Publish hanzo-mcp package
	@echo -e "$(CYAN)Publishing hanzo-mcp...$(NC)"
	@cd pkg/hanzo-mcp && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-cli: ## Publish hanzo-cli package
	@echo -e "$(CYAN)Publishing hanzo-cli...$(NC)"
	@cd pkg/hanzo-cli && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo: ## Publish hanzo wrapper package
	@echo -e "$(CYAN)Building and publishing hanzo wrapper...$(NC)"
	@cd pkg/hanzo-wrapper && python -m build && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-repl: ## Publish hanzo-repl package
	@echo -e "$(CYAN)Publishing hanzo-repl...$(NC)"
	@cd pkg/hanzo-repl && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-memory: ## Publish hanzo-memory package
	@echo -e "$(CYAN)Publishing hanzo-memory...$(NC)"
	@cd pkg/hanzo-memory && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-network: ## Publish hanzo-network package
	@echo -e "$(CYAN)Publishing hanzo-network...$(NC)"
	@cd pkg/hanzo-network && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-mcp-client: ## Publish hanzo-mcp-client package
	@echo -e "$(CYAN)Publishing hanzo-mcp-client...$(NC)"
	@cd pkg/hanzo-mcp-client && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

publish-hanzo-aci: ## Publish hanzo-aci as dev-aci package
	@echo -e "$(CYAN)Publishing hanzo-aci as dev-aci...$(NC)"
	@cd pkg/hanzo-aci && TWINE_USERNAME=__token__ TWINE_PASSWORD=$${PYPI_TOKEN} twine upload dist/* --skip-existing

# Individual package commands
test-hanzoai: ## Test main hanzoai package
	@source .venv/bin/activate && python -m pytest tests/ -v

test-agents: ## Test hanzo-agents package
	@source .venv/bin/activate && cd pkg/hanzo-agents && python -m pytest tests/ -v

test-mcp: ## Test hanzo-mcp package
	@source .venv/bin/activate && cd pkg/hanzo-mcp && python -m pytest tests/ -v

test-memory: ## Test hanzo-memory package
	@source .venv/bin/activate && cd pkg/hanzo-memory && python -m pytest tests/ -v

test-aci: ## Test hanzo-aci package
	@source .venv/bin/activate && cd pkg/hanzo-aci && python -m pytest tests/ -v

# Development helpers
shell: ## Start Python shell with packages loaded
	@source .venv/bin/activate && python

watch-tests: ## Watch and run tests on file changes
	@source .venv/bin/activate && watchmedo shell-command \
		--patterns="*.py" \
		--recursive \
		--command='make test' \
		.

update-deps: ## Update all dependencies to latest versions
	@echo -e "$(CYAN)Updating dependencies...$(NC)"
	@source .venv/bin/activate && uv pip compile pyproject.toml -o requirements.txt --upgrade
	@source .venv/bin/activate && uv pip sync requirements.txt
	@echo -e "$(GREEN)Dependencies updated$(NC)"

check-types: ## Run type checking
	@echo -e "$(CYAN)Running type checks...$(NC)"
	@source .venv/bin/activate && mypy pkg/hanzoai --ignore-missing-imports
	@source .venv/bin/activate && pyright pkg/hanzoai || true
	@echo -e "$(GREEN)Type checking completed$(NC)"

coverage: ## Run tests with coverage
	@echo -e "$(CYAN)Running tests with coverage...$(NC)"
	@source .venv/bin/activate && coverage run -m pytest tests/
	@source .venv/bin/activate && coverage report
	@source .venv/bin/activate && coverage html
	@echo -e "$(GREEN)Coverage report generated in htmlcov/$(NC)"