russell@unturf.com
798336a16d
Add per-client Makefiles following the 4-mode testing pattern: - CLI mode: Syntax validation, --help checks - Library mode: Import/require tests, unit tests - Integration mode: API contract validation - Functional mode: Real-world scenario tests All Makefiles gracefully handle missing implementations by skipping tests and showing appropriate status messages. JavaScript client has working sync SDK (un.js) with: - 14 exported functions - HMAC-SHA256 authentication - Language caching Other clients (Rust, Ruby, PHP, Java) have scaffold directories ready for implementation.
248 lines
10 KiB
Makefile
248 lines
10 KiB
Makefile
# UN Java Client - Build and Test
|
|
#
|
|
# This client has two implementations:
|
|
# - sync/ : Synchronous Java SDK (HttpURLConnection)
|
|
# - async/ : Asynchronous Java SDK (CompletableFuture/HttpClient)
|
|
#
|
|
# Usage:
|
|
# make # Build all
|
|
# make test # Run all 4 test modes
|
|
# make test-cli # CLI mode only
|
|
# make test-library # Library mode only
|
|
# make test-integration # Integration mode only
|
|
# make test-functional # Functional mode only
|
|
# make build # Build JAR files
|
|
# make clean # Remove build artifacts
|
|
#
|
|
# Dependencies:
|
|
# Java 11+ (for HttpClient)
|
|
# Maven or Gradle
|
|
|
|
.PHONY: all build test test-cli test-library test-integration test-functional
|
|
.PHONY: test-sync test-async clean help examples
|
|
|
|
# Paths
|
|
ROOT_DIR := $(shell cd ../.. && pwd)
|
|
SYNC_DIR := sync
|
|
ASYNC_DIR := async
|
|
|
|
# Java settings
|
|
JAVA := java
|
|
JAVAC := javac
|
|
MAVEN := mvn
|
|
GRADLE := gradle
|
|
|
|
# Colors
|
|
GREEN := \033[32m
|
|
RED := \033[31m
|
|
YELLOW := \033[33m
|
|
NC := \033[0m
|
|
|
|
.DEFAULT_GOAL := help
|
|
|
|
help:
|
|
@echo "UN Java Client - Build and Test"
|
|
@echo ""
|
|
@echo "Build:"
|
|
@echo " make build Build all JARs"
|
|
@echo " make build-sync Build sync SDK"
|
|
@echo " make build-async Build async SDK"
|
|
@echo ""
|
|
@echo "Test (all 4 modes):"
|
|
@echo " make test All 4 modes for both sync and async"
|
|
@echo " make test-cli CLI mode (command-line interface)"
|
|
@echo " make test-library Library mode (JUnit tests)"
|
|
@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 "Utility:"
|
|
@echo " make clean Remove build artifacts"
|
|
@echo " make deps Show required dependencies"
|
|
@echo ""
|
|
|
|
all: build
|
|
|
|
deps:
|
|
@echo "Required:"
|
|
@echo " Java 11+ (for HttpClient)"
|
|
@echo " Maven or Gradle"
|
|
@echo ""
|
|
@java -version 2>&1 | head -1 || echo "Java not installed"
|
|
@mvn --version 2>/dev/null | head -1 || echo "Maven not installed (optional)"
|
|
@gradle --version 2>/dev/null | head -1 || echo "Gradle not installed (optional)"
|
|
|
|
# ============================================================================
|
|
# BUILD
|
|
# ============================================================================
|
|
|
|
build: build-sync build-async
|
|
@echo "$(GREEN)✓ All Java SDKs built$(NC)"
|
|
|
|
build-sync:
|
|
@echo "Building sync SDK..."
|
|
@if [ -f "$(SYNC_DIR)/pom.xml" ]; then \
|
|
cd $(SYNC_DIR) && $(MAVEN) compile -q && echo "$(GREEN)✓$(NC) Sync SDK compiled (Maven)"; \
|
|
elif [ -f "$(SYNC_DIR)/build.gradle" ]; then \
|
|
cd $(SYNC_DIR) && $(GRADLE) build -q && echo "$(GREEN)✓$(NC) Sync SDK compiled (Gradle)"; \
|
|
elif [ -d "$(SYNC_DIR)/src" ]; then \
|
|
echo "$(YELLOW)⊘$(NC) Sync SDK needs pom.xml or build.gradle"; \
|
|
else \
|
|
echo "$(YELLOW)⊘$(NC) Sync SDK not found"; \
|
|
fi
|
|
|
|
build-async:
|
|
@echo "Building async SDK..."
|
|
@if [ -f "$(ASYNC_DIR)/pom.xml" ]; then \
|
|
cd $(ASYNC_DIR) && $(MAVEN) compile -q && echo "$(GREEN)✓$(NC) Async SDK compiled (Maven)"; \
|
|
elif [ -f "$(ASYNC_DIR)/build.gradle" ]; then \
|
|
cd $(ASYNC_DIR) && $(GRADLE) build -q && echo "$(GREEN)✓$(NC) Async SDK compiled (Gradle)"; \
|
|
elif [ -d "$(ASYNC_DIR)/src" ]; then \
|
|
echo "$(YELLOW)⊘$(NC) Async SDK needs pom.xml or build.gradle"; \
|
|
else \
|
|
echo "$(YELLOW)⊘$(NC) Async SDK not found"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: All 4 Modes
|
|
# ============================================================================
|
|
|
|
test: test-cli test-library test-integration test-functional
|
|
@echo ""
|
|
@echo "$(GREEN)✓ Java Client: All 4 test modes complete$(NC)"
|
|
|
|
# ============================================================================
|
|
# TEST: CLI Mode
|
|
# ============================================================================
|
|
|
|
test-cli:
|
|
@echo ""
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo "CLI MODE: Testing Java CLI interface"
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo ""
|
|
@# Test sync SDK compile
|
|
@if [ -f "$(SYNC_DIR)/pom.xml" ]; then \
|
|
cd $(SYNC_DIR) && $(MAVEN) compile -q 2>/dev/null && echo " $(GREEN)✓$(NC) CLI: Sync SDK compiles (Maven)" || echo " $(RED)✗$(NC) CLI: Sync SDK compile failed"; \
|
|
elif [ -f "$(SYNC_DIR)/build.gradle" ]; then \
|
|
cd $(SYNC_DIR) && $(GRADLE) compileJava -q 2>/dev/null && echo " $(GREEN)✓$(NC) CLI: Sync SDK compiles (Gradle)" || echo " $(RED)✗$(NC) CLI: Sync SDK compile failed"; \
|
|
elif [ -d "$(SYNC_DIR)/src" ]; then \
|
|
echo " $(YELLOW)⊘$(NC) CLI: Sync SDK needs build configuration"; \
|
|
fi
|
|
@# Test async SDK compile
|
|
@if [ -f "$(ASYNC_DIR)/pom.xml" ]; then \
|
|
cd $(ASYNC_DIR) && $(MAVEN) compile -q 2>/dev/null && echo " $(GREEN)✓$(NC) CLI: Async SDK compiles (Maven)" || echo " $(YELLOW)⊘$(NC) CLI: Async SDK not yet buildable"; \
|
|
elif [ -f "$(ASYNC_DIR)/build.gradle" ]; then \
|
|
cd $(ASYNC_DIR) && $(GRADLE) compileJava -q 2>/dev/null && echo " $(GREEN)✓$(NC) CLI: Async SDK compiles (Gradle)" || echo " $(YELLOW)⊘$(NC) CLI: Async SDK not yet buildable"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: Library Mode
|
|
# ============================================================================
|
|
|
|
test-library:
|
|
@echo ""
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo "LIBRARY MODE: Testing Java classes"
|
|
@echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
@echo ""
|
|
@# Test sync SDK with Maven/Gradle test
|
|
@if [ -f "$(SYNC_DIR)/pom.xml" ]; then \
|
|
cd $(SYNC_DIR) && $(MAVEN) test -q 2>&1 | tail -10 || echo " $(YELLOW)⊘$(NC) Library: Sync tests incomplete"; \
|
|
elif [ -f "$(SYNC_DIR)/build.gradle" ]; then \
|
|
cd $(SYNC_DIR) && $(GRADLE) test -q 2>&1 | tail -10 || echo " $(YELLOW)⊘$(NC) Library: Sync tests incomplete"; \
|
|
else \
|
|
echo " $(YELLOW)⊘$(NC) Library: Sync SDK needs build configuration"; \
|
|
fi
|
|
@# Test async SDK
|
|
@if [ -f "$(ASYNC_DIR)/pom.xml" ]; then \
|
|
cd $(ASYNC_DIR) && $(MAVEN) test -q 2>&1 | tail -10 || echo " $(YELLOW)⊘$(NC) Library: Async tests incomplete"; \
|
|
elif [ -f "$(ASYNC_DIR)/build.gradle" ]; then \
|
|
cd $(ASYNC_DIR) && $(GRADLE) test -q 2>&1 | tail -10 || echo " $(YELLOW)⊘$(NC) Library: Async tests incomplete"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: Integration Mode
|
|
# ============================================================================
|
|
|
|
test-integration:
|
|
@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..."; \
|
|
echo " $(YELLOW)⊘$(NC) Integration: SDK not yet implemented"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: Functional Mode
|
|
# ============================================================================
|
|
|
|
test-functional:
|
|
@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..."; \
|
|
echo " $(YELLOW)⊘$(NC) Functional: SDK not yet implemented"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# TEST: By SDK Type
|
|
# ============================================================================
|
|
|
|
test-sync:
|
|
@echo "Testing Sync SDK..."
|
|
@if [ -f "$(SYNC_DIR)/pom.xml" ]; then \
|
|
cd $(SYNC_DIR) && $(MAVEN) test; \
|
|
elif [ -f "$(SYNC_DIR)/build.gradle" ]; then \
|
|
cd $(SYNC_DIR) && $(GRADLE) test; \
|
|
else \
|
|
echo " $(YELLOW)⊘$(NC) Sync SDK tests not found"; \
|
|
fi
|
|
|
|
test-async:
|
|
@echo "Testing Async SDK..."
|
|
@if [ -f "$(ASYNC_DIR)/pom.xml" ]; then \
|
|
cd $(ASYNC_DIR) && $(MAVEN) test; \
|
|
elif [ -f "$(ASYNC_DIR)/build.gradle" ]; then \
|
|
cd $(ASYNC_DIR) && $(GRADLE) test; \
|
|
else \
|
|
echo " $(YELLOW)⊘$(NC) Async SDK tests not found"; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# Examples
|
|
# ============================================================================
|
|
|
|
examples:
|
|
@echo "Running Java examples..."
|
|
@if [ -f "$(SYNC_DIR)/pom.xml" ]; then \
|
|
cd $(SYNC_DIR) && $(MAVEN) exec:java -Dexec.mainClass="examples.HelloWorld" 2>&1 | head -10 || true; \
|
|
fi
|
|
|
|
# ============================================================================
|
|
# Clean
|
|
# ============================================================================
|
|
|
|
clean:
|
|
@echo "Cleaning Java build artifacts..."
|
|
@if [ -f "$(SYNC_DIR)/pom.xml" ]; then cd $(SYNC_DIR) && $(MAVEN) clean -q 2>/dev/null || true; fi
|
|
@if [ -f "$(ASYNC_DIR)/pom.xml" ]; then cd $(ASYNC_DIR) && $(MAVEN) clean -q 2>/dev/null || true; fi
|
|
@if [ -f "$(SYNC_DIR)/build.gradle" ]; then cd $(SYNC_DIR) && $(GRADLE) clean -q 2>/dev/null || true; fi
|
|
@if [ -f "$(ASYNC_DIR)/build.gradle" ]; then cd $(ASYNC_DIR) && $(GRADLE) clean -q 2>/dev/null || true; fi
|
|
@rm -rf $(SYNC_DIR)/target $(ASYNC_DIR)/target 2>/dev/null || true
|
|
@rm -rf $(SYNC_DIR)/build $(ASYNC_DIR)/build 2>/dev/null || true
|
|
@echo "$(GREEN)✓$(NC) Cleaned build artifacts"
|