russell@unturf.com
de8c816b27
Each test file covers 10 real API tests matching the C SDK reference: health_check, validate_keys, get_languages, execute, execute_error, session_list, session_lifecycle, service_list, snapshot_list, image_list. All tests skip cleanly without credentials. No soft passes. Updated all 7 Makefiles to run dedicated functional test files.
233 lines
10 KiB
Makefile
233 lines
10 KiB
Makefile
# UN Python Client - Build and Test
|
|
#
|
|
# This client has two implementations:
|
|
# - sync/ : Synchronous Python SDK (requests-based)
|
|
# - async/ : Asynchronous Python SDK (aiohttp-based)
|
|
#
|
|
# Usage:
|
|
# make test # Run all 4 test modes (auto-creates venv)
|
|
# make test-cli # CLI mode only
|
|
# make test-library # Library mode only
|
|
# make test-sync # Test sync SDK only
|
|
# make test-async # Test async SDK only
|
|
# make clean # Remove build artifacts + venv
|
|
#
|
|
# The Makefile manages a .venv automatically. No manual pip install needed.
|
|
|
|
.PHONY: all test test-cli test-library test-integration test-functional
|
|
.PHONY: test-sync test-async lint format clean help examples venv
|
|
|
|
# Paths
|
|
ROOT_DIR := $(shell cd ../.. && pwd)
|
|
SYNC_DIR := sync
|
|
ASYNC_DIR := async
|
|
VENV := .venv
|
|
PYTHON := $(VENV)/bin/python
|
|
PYTEST := $(VENV)/bin/pytest
|
|
|
|
# Colors
|
|
GREEN := \033[32m
|
|
RED := \033[31m
|
|
YELLOW := \033[33m
|
|
NC := \033[0m
|
|
|
|
.DEFAULT_GOAL := help
|
|
|
|
help:
|
|
@echo "UN Python Client - Build and Test"
|
|
@echo ""
|
|
@echo "Test (all 4 modes):"
|
|
@echo " make test All 4 modes (auto-creates venv)"
|
|
@echo " make test-cli CLI mode (command-line interface)"
|
|
@echo " make test-library Library mode (import and use)"
|
|
@echo " make test-integration Integration mode (API contract)"
|
|
@echo " make test-functional Functional mode (real-world scenarios)"
|
|
@echo ""
|
|
@echo "Test by SDK:"
|
|
@echo " make test-sync Test synchronous SDK"
|
|
@echo " make test-async Test asynchronous SDK"
|
|
@echo ""
|
|
@echo "Development:"
|
|
@echo " make venv Create/update virtual environment"
|
|
@echo " make lint Lint both SDKs"
|
|
@echo " make format Format both SDKs"
|
|
@echo " make examples Run example scripts"
|
|
@echo ""
|
|
@echo "Utility:"
|
|
@echo " make clean Remove build artifacts + venv"
|
|
@echo ""
|
|
|
|
all: test
|
|
|
|
# ============================================================================
|
|
# Virtual Environment
|
|
# ============================================================================
|
|
|
|
$(VENV)/bin/activate:
|
|
@echo "Creating virtual environment..."
|
|
@python3 -m venv $(VENV)
|
|
@$(VENV)/bin/pip install --upgrade pip -q
|
|
|
|
$(VENV)/.deps-installed: $(VENV)/bin/activate
|
|
@echo "Installing test dependencies into venv..."
|
|
@$(VENV)/bin/pip install -q requests pytest pytest-cov pytest-asyncio aiohttp
|
|
@if [ -f "$(SYNC_DIR)/setup.py" ]; then \
|
|
cd $(SYNC_DIR) && ../$(VENV)/bin/pip install -q -e . 2>/dev/null || true; \
|
|
fi
|
|
@if [ -f "$(ASYNC_DIR)/setup.py" ]; then \
|
|
cd $(ASYNC_DIR) && ../$(VENV)/bin/pip install -q -e . 2>/dev/null || true; \
|
|
fi
|
|
@touch $(VENV)/.deps-installed
|
|
|
|
venv: $(VENV)/.deps-installed
|
|
@echo "$(GREEN)✓$(NC) Virtual environment ready at $(VENV)/"
|
|
|
|
# ============================================================================
|
|
# TEST: All 4 Modes
|
|
# ============================================================================
|
|
|
|
test: test-cli test-library test-integration test-functional
|
|
@echo ""
|
|
@echo "$(GREEN)✓ Python Client: All 4 test modes complete$(NC)"
|
|
|
|
# ============================================================================
|
|
# TEST: CLI Mode
|
|
# ============================================================================
|
|
|
|
test-cli: $(VENV)/.deps-installed
|
|
@echo ""
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo "CLI MODE: Testing Python CLI interface"
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo ""
|
|
@if [ -f "$(ROOT_DIR)/un.py" ]; then \
|
|
$(PYTHON) -m py_compile "$(ROOT_DIR)/un.py" && echo " $(GREEN)✓$(NC) CLI: Syntax valid (un.py)"; \
|
|
$(PYTHON) "$(ROOT_DIR)/un.py" --help > /dev/null 2>&1 && echo " $(GREEN)✓$(NC) CLI: --help works" || echo " $(YELLOW)⊘$(NC) CLI: --help (may need API)"; \
|
|
else \
|
|
echo " $(YELLOW)⊘$(NC) Root un.py not found"; \
|
|
fi
|
|
@if [ -f "$(SYNC_DIR)/src/unsandbox/__main__.py" ]; then \
|
|
$(PYTHON) -m py_compile "$(SYNC_DIR)/src/unsandbox/__main__.py" && echo " $(GREEN)✓$(NC) CLI: Sync SDK syntax valid"; \
|
|
fi
|
|
@if [ -f "$(ASYNC_DIR)/src/un_async/__main__.py" ]; then \
|
|
$(PYTHON) -m py_compile "$(ASYNC_DIR)/src/un_async/__main__.py" && echo " $(GREEN)✓$(NC) CLI: Async SDK syntax valid"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: Library Mode
|
|
# ============================================================================
|
|
|
|
test-library: $(VENV)/.deps-installed
|
|
@echo ""
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo "LIBRARY MODE: Testing Python imports"
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo ""
|
|
@if [ -d "$(SYNC_DIR)/src/unsandbox" ]; then \
|
|
cd $(SYNC_DIR) && PYTHONPATH=src ../$(PYTHON) -c "from unsandbox import UnsandboxClient; print(' ✓ Library: Sync UnsandboxClient importable')" 2>/dev/null || echo " $(YELLOW)⊘$(NC) Library: Sync import failed"; \
|
|
fi
|
|
@if [ -d "$(ASYNC_DIR)/src/un_async" ]; then \
|
|
cd $(ASYNC_DIR) && PYTHONPATH=src ../$(PYTHON) -c "from un_async import AsyncUnsandboxClient; print(' ✓ Library: Async AsyncUnsandboxClient importable')" 2>/dev/null || echo " $(YELLOW)⊘$(NC) Library: Async import failed"; \
|
|
fi
|
|
@echo ""
|
|
@echo "Running unit tests..."
|
|
@if [ -d "$(SYNC_DIR)/tests" ]; then \
|
|
cd $(SYNC_DIR) && PYTHONPATH=src ../$(PYTEST) tests/ -q --tb=short 2>&1 && echo " $(GREEN)✓$(NC) Sync SDK tests passed" || echo " $(RED)✗$(NC) Sync tests failed"; \
|
|
fi
|
|
@if [ -d "$(ASYNC_DIR)/tests" ]; then \
|
|
cd $(ASYNC_DIR) && PYTHONPATH=src ../$(PYTEST) tests/ -q --tb=short 2>&1 && echo " $(GREEN)✓$(NC) Async SDK tests passed" || echo " $(RED)✗$(NC) Async tests failed"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: Integration Mode
|
|
# ============================================================================
|
|
|
|
test-integration: $(VENV)/.deps-installed
|
|
@echo ""
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo "INTEGRATION MODE: Testing API contract"
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo ""
|
|
@if [ -z "$$UNSANDBOX_PUBLIC_KEY" ] || [ -z "$$UNSANDBOX_SECRET_KEY" ]; then \
|
|
echo " $(YELLOW)⊘$(NC) Skipping (no API credentials)"; \
|
|
echo " Set UNSANDBOX_PUBLIC_KEY and UNSANDBOX_SECRET_KEY"; \
|
|
else \
|
|
echo " Testing API authentication..."; \
|
|
$(PYTHON) -c "import sys; sys.path.insert(0, '$(SYNC_DIR)/src'); from unsandbox import UnsandboxClient; c = UnsandboxClient(); r = c.execute('python', 'print(42)'); print(' ✓ Integration: API auth works') if r else print(' ✗ Integration: API auth failed')" 2>/dev/null || echo " $(RED)✗$(NC) Integration: SDK error"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: Functional Mode
|
|
# ============================================================================
|
|
|
|
test-functional: $(VENV)/.deps-installed
|
|
@echo ""
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo "FUNCTIONAL MODE: Real-world scenarios"
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo ""
|
|
@if [ -z "$$UNSANDBOX_PUBLIC_KEY" ] || [ -z "$$UNSANDBOX_SECRET_KEY" ]; then \
|
|
echo " $(YELLOW)⊘$(NC) Skipping (no API credentials)"; \
|
|
else \
|
|
echo " Running functional tests..."; \
|
|
cd $(SYNC_DIR) && PYTHONPATH=src ../$(PYTEST) tests/test_functional.py -v 2>&1 && echo " $(GREEN)✓$(NC) Functional: Sync SDK verified" || echo " $(RED)✗$(NC) Functional: Sync verification failed"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: By SDK Type
|
|
# ============================================================================
|
|
|
|
test-sync: $(VENV)/.deps-installed
|
|
@echo "Testing Sync SDK..."
|
|
@if [ -d "$(SYNC_DIR)/tests" ]; then \
|
|
cd $(SYNC_DIR) && PYTHONPATH=src ../$(PYTEST) tests/ -v; \
|
|
else \
|
|
echo " $(YELLOW)⊘$(NC) Sync SDK tests not found"; \
|
|
fi
|
|
|
|
test-async: $(VENV)/.deps-installed
|
|
@echo "Testing Async SDK..."
|
|
@if [ -d "$(ASYNC_DIR)/tests" ]; then \
|
|
cd $(ASYNC_DIR) && PYTHONPATH=src ../$(PYTEST) tests/ -v; \
|
|
else \
|
|
echo " $(YELLOW)⊘$(NC) Async SDK tests not found"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# Development
|
|
# ============================================================================
|
|
|
|
lint: $(VENV)/.deps-installed
|
|
@echo "Linting Python SDKs..."
|
|
@$(VENV)/bin/pip install -q flake8 2>/dev/null || true
|
|
@if [ -d "$(SYNC_DIR)/src" ]; then $(VENV)/bin/flake8 $(SYNC_DIR)/src/ --max-line-length=120 || true; fi
|
|
@if [ -d "$(ASYNC_DIR)/src" ]; then $(VENV)/bin/flake8 $(ASYNC_DIR)/src/ --max-line-length=120 || true; fi
|
|
@echo "$(GREEN)✓$(NC) Lint complete"
|
|
|
|
format: $(VENV)/.deps-installed
|
|
@echo "Formatting Python SDKs..."
|
|
@$(VENV)/bin/pip install -q black 2>/dev/null || true
|
|
@if [ -d "$(SYNC_DIR)/src" ]; then $(VENV)/bin/black $(SYNC_DIR)/src/ $(SYNC_DIR)/tests/ 2>/dev/null || true; fi
|
|
@if [ -d "$(ASYNC_DIR)/src" ]; then $(VENV)/bin/black $(ASYNC_DIR)/src/ $(ASYNC_DIR)/tests/ 2>/dev/null || true; fi
|
|
@echo "$(GREEN)✓$(NC) Format complete"
|
|
|
|
examples: $(VENV)/.deps-installed
|
|
@echo "Running Python examples..."
|
|
@if [ -f "$(ASYNC_DIR)/Makefile" ]; then $(MAKE) -C $(ASYNC_DIR) examples; fi
|
|
|
|
# ============================================================================
|
|
# Clean
|
|
# ============================================================================
|
|
|
|
clean:
|
|
@echo "Cleaning Python build artifacts..."
|
|
@rm -rf $(VENV)
|
|
@find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
|
|
@find . -type f -name "*.pyc" -delete 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 "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
|
|
@find . -type d -name "htmlcov" -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
|
|
@echo "$(GREEN)✓$(NC) Cleaned build artifacts + venv"
|