jekyll-theme-zer0 0.8.1 → 0.10.3

data/scripts/test/integration/auto-version

@@ -0,0 +1,243 @@
+#!/bin/bash
+
+# Test Script for Automated Version Bump System
+# Tests the commit analysis and version bump automation
+# Usage: ./scripts/test/integration/auto-version
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPTS_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPTS_ROOT/.." && pwd)"
+LIB_DIR="$SCRIPTS_ROOT/lib"
+
+# Source common library for logging and utilities
+source "$LIB_DIR/common.sh"
+
+# Aliases for backward compatibility
+log_info() { info "$@"; }
+log_success() { success "$@"; }
+log_warning() { warn "$@"; }
+log_error() { error "$@"; }
+log_test() { step "$@"; }
+
+# Test counter
+TESTS_RUN=0
+TESTS_PASSED=0
+
+run_test() {
+    local test_name="$1"
+    local test_command="$2"
+    local expected_result="${3:-}"
+    
+    ((TESTS_RUN++))
+    log_test "Running: $test_name"
+    
+    local actual_result
+    if actual_result=$(eval "$test_command" 2>&1); then
+        if [[ -n "$expected_result" ]]; then
+            if [[ "$actual_result" == "$expected_result" ]]; then
+                log_success "✅ $test_name"
+                ((TESTS_PASSED++))
+            else
+                log_error "❌ $test_name - Expected: '$expected_result', Got: '$actual_result'"
+            fi
+        else
+            log_success "✅ $test_name"
+            ((TESTS_PASSED++))
+        fi
+    else
+        log_error "❌ $test_name - Command failed: $actual_result"
+    fi
+}
+
+# Test the commit analysis script
+test_commit_analysis() {
+    log_info "Testing commit analysis functionality..."
+    
+    # Test script exists and is executable
+    run_test "Commit analysis script exists" "test -x '$SCRIPT_DIR/analyze-commits.sh'"
+    
+    # Test help output
+    run_test "Help output works" "$SCRIPT_DIR/analyze-commits.sh --help | grep -q 'Commit Analysis Script'"
+    
+    # Test with sample commit ranges (if we have git history)
+    if git rev-list --count HEAD >/dev/null 2>&1; then
+        local commit_count=$(git rev-list --count HEAD)
+        
+        if [[ $commit_count -gt 1 ]]; then
+            # Test analyzing last commit
+            run_test "Analyze last commit" "$SCRIPT_DIR/analyze-commits.sh HEAD~1..HEAD | grep -E '^(patch|minor|major|none)$'"
+            
+            # Test analyzing multiple commits if available
+            if [[ $commit_count -gt 3 ]]; then
+                run_test "Analyze multiple commits" "$SCRIPT_DIR/analyze-commits.sh HEAD~3..HEAD | grep -E '^(patch|minor|major|none)$'"
+            fi
+        fi
+    else
+        log_warning "No git history available for commit analysis tests"
+    fi
+}
+
+# Test gem publication script compatibility
+test_gem_publish_script() {
+    log_info "Testing gem publication script compatibility..."
+    
+    # Test script exists and is executable
+    run_test "Gem publish script exists" "test -x '$SCRIPT_DIR/gem-publish.sh'"
+    
+    # Test new automated options
+    run_test "Automated release option works" "$SCRIPT_DIR/gem-publish.sh --help | grep -q 'automated-release'"
+    run_test "Auto commit range option works" "$SCRIPT_DIR/gem-publish.sh --help | grep -q 'auto-commit-range'"
+    
+    # Test dry run with automated options
+    if [[ -f "$PROJECT_ROOT/lib/jekyll-theme-zer0/version.rb" ]]; then
+        run_test "Dry run with automated options" "$SCRIPT_DIR/gem-publish.sh patch --dry-run --automated-release --skip-tests --skip-publish --no-github-release | grep -q 'Automated Release Mode'"
+    fi
+}
+
+# Test workflow files syntax
+test_workflow_syntax() {
+    log_info "Testing GitHub Actions workflow syntax..."
+    
+    # Check if yamllint is available
+    if command -v yamllint >/dev/null 2>&1; then
+        run_test "Auto-version-bump workflow syntax" "yamllint '$PROJECT_ROOT/.github/workflows/auto-version-bump.yml'"
+    else
+        # Basic YAML syntax check with Python
+        if command -v python3 >/dev/null 2>&1; then
+            run_test "Auto-version-bump workflow syntax" "python3 -c 'import yaml; yaml.safe_load(open(\"$PROJECT_ROOT/.github/workflows/auto-version-bump.yml\"))'"
+        else
+            log_warning "Neither yamllint nor python3 available for YAML validation"
+        fi
+    fi
+}
+
+# Test file permissions and executability
+test_file_permissions() {
+    log_info "Testing file permissions..."
+    
+    local scripts=(
+        "$SCRIPT_DIR/analyze-commits.sh"
+        "$SCRIPT_DIR/gem-publish.sh"
+    )
+    
+    for script in "${scripts[@]}"; do
+        local script_name=$(basename "$script")
+        run_test "$script_name is executable" "test -x '$script'"
+    done
+}
+
+# Test integration between components
+test_integration() {
+    log_info "Testing integration between components..."
+    
+    # Test that analyze-commits.sh can be called by the workflow
+    if [[ -x "$SCRIPT_DIR/analyze-commits.sh" ]]; then
+        # Test with a simple commit range
+        if git rev-list --count HEAD >/dev/null 2>&1; then
+            local commit_count=$(git rev-list --count HEAD)
+            if [[ $commit_count -gt 0 ]]; then
+                run_test "Integration: commit analysis returns valid output" "$SCRIPT_DIR/analyze-commits.sh HEAD~1..HEAD | grep -E '^(patch|minor|major|none)$'"
+            fi
+        fi
+    fi
+    
+    # Test that gem-publish.sh accepts the new parameters
+    if [[ -x "$SCRIPT_DIR/gem-publish.sh" ]]; then
+        run_test "Integration: gem-publish accepts automated params" "$SCRIPT_DIR/gem-publish.sh patch --dry-run --automated-release --auto-commit-range=HEAD~1..HEAD --skip-tests --skip-publish --no-github-release | grep -q 'DRY RUN MODE'"
+    fi
+}
+
+# Test conventional commit detection
+test_conventional_commits() {
+    log_info "Testing conventional commit detection..."
+    
+    # Create test commits in memory (don't actually commit)
+    local test_commits=(
+        "feat: add new feature"
+        "fix: resolve bug in component"
+        "BREAKING CHANGE: remove deprecated API"
+        "chore: update dependencies"
+        "docs: improve documentation"
+    )
+    
+    local expected_results=(
+        "minor"
+        "patch" 
+        "major"
+        "patch"
+        "patch"
+    )
+    
+    # Note: This would require a more sophisticated test setup
+    # For now, just test that the patterns exist in the script
+    run_test "Conventional commit patterns exist" "grep -q 'feat.*minor' '$SCRIPT_DIR/analyze-commits.sh'"
+    run_test "Fix patterns exist" "grep -q 'fix.*patch' '$SCRIPT_DIR/analyze-commits.sh'"
+    run_test "Breaking change patterns exist" "grep -q 'BREAKING.*major' '$SCRIPT_DIR/analyze-commits.sh'"
+}
+
+# Main test execution
+main() {
+    log_info "🧪 Starting Automated Version Bump System Tests"
+    echo "=================================================="
+    echo ""
+    
+    # Change to project root
+    cd "$PROJECT_ROOT"
+    
+    # Run all test suites
+    test_file_permissions
+    test_commit_analysis
+    test_gem_publish_script
+    test_workflow_syntax
+    test_integration
+    test_conventional_commits
+    
+    # Test summary
+    echo ""
+    echo "=================================================="
+    log_info "🎯 Test Results Summary"
+    echo "Tests Run: $TESTS_RUN"
+    echo "Tests Passed: $TESTS_PASSED"
+    echo "Tests Failed: $((TESTS_RUN - TESTS_PASSED))"
+    
+    if [[ $TESTS_PASSED -eq $TESTS_RUN ]]; then
+        log_success "🎉 All tests passed! Automated version bump system is ready."
+        exit 0
+    else
+        log_error "❌ Some tests failed. Please review the issues above."
+        exit 1
+    fi
+}
+
+# Show usage if requested
+if [[ "${1:-}" == "--help" ]] || [[ "${1:-}" == "-h" ]]; then
+    cat << EOF
+Test Script for Automated Version Bump System
+
+USAGE:
+    $0
+
+DESCRIPTION:
+    This script tests the automated version bump system including:
+    - Commit analysis functionality
+    - Gem publication script compatibility  
+    - Workflow file syntax validation
+    - Integration between components
+    - Conventional commit detection
+
+REQUIREMENTS:
+    - Git repository with commit history
+    - Executable scripts in scripts/ directory
+    - Valid GitHub Actions workflow files
+
+OUTPUT:
+    Detailed test results and summary
+    Exit code 0 on success, 1 on failure
+EOF
+    exit 0
+fi
+
+# Execute main function
+main "$@"

data/scripts/test/integration/mermaid

@@ -0,0 +1,252 @@
+#!/bin/bash
+
+###############################################################################
+# Mermaid Integration Test Script
+# 
+# Purpose: Comprehensive testing of Mermaid.js integration in Jekyll
+# Usage: ./scripts/test/integration/mermaid [options]
+# Options:
+#   --verbose    Show detailed output
+#   --headless   Run in headless mode (for CI/CD)
+#   --quick      Run quick validation only
+#   --local      Test local Jekyll server
+#   --docker     Test Docker container
+###############################################################################
+
+set -euo pipefail
+
+# Get script directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPTS_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+LIB_DIR="$SCRIPTS_ROOT/lib"
+
+# Source common library for logging and utilities
+source "$LIB_DIR/common.sh"
+
+# Test counters
+TESTS_PASSED=0
+TESTS_FAILED=0
+TOTAL_TESTS=0
+
+# Configuration
+export VERBOSE=${VERBOSE:-false}
+HEADLESS=false
+QUICK=false
+TEST_MODE="both"  # local, docker, both
+
+# Parse arguments
+for arg in "$@"; do
+  case $arg in
+    --verbose)
+      export VERBOSE=true
+      shift
+      ;;
+    --headless)
+      HEADLESS=true
+      shift
+      ;;
+    --quick)
+      QUICK=true
+      shift
+      ;;
+    --local)
+      TEST_MODE="local"
+      shift
+      ;;
+    --docker)
+      TEST_MODE="docker"
+      shift
+      ;;
+    --help)
+      echo "Usage: $0 [options]"
+      echo "Options:"
+      echo "  --verbose    Show detailed output"
+      echo "  --headless   Run in headless mode (for CI/CD)"
+      echo "  --quick      Run quick validation only"
+      echo "  --local      Test local Jekyll server only"
+      echo "  --docker     Test Docker container only"
+      echo "  --help       Show this help message"
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $arg"
+      echo "Use --help for usage information"
+      exit 1
+      ;;
+  esac
+done
+
+# Logging functions
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[✓]${NC} $1"; }
+log_warning() { echo -e "${YELLOW}[!]${NC} $1"; }
+log_error() { echo -e "${RED}[✗]${NC} $1"; }
+
+# Test function
+run_test() {
+    local test_name="$1"
+    local test_command="$2"
+    
+    TOTAL_TESTS=$((TOTAL_TESTS + 1))
+    
+    if [ "$VERBOSE" = true ]; then
+        log_info "Running: $test_name"
+    fi
+    
+    if eval "$test_command" >/dev/null 2>&1; then
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+        log_success "$test_name"
+        return 0
+    else
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        log_error "$test_name"
+        return 1
+    fi
+}
+
+# Test file existence
+test_file_exists() {
+    local file_path="$1"
+    local description="$2"
+    
+    run_test "$description" "[ -f '$file_path' ]"
+}
+
+# Test file content
+test_file_content() {
+    local file_path="$1"
+    local pattern="$2"
+    local description="$3"
+    
+    run_test "$description" "grep -q '$pattern' '$file_path'"
+}
+
+# Test URL accessibility
+test_url() {
+    local url="$1"
+    local description="$2"
+    
+    run_test "$description" "curl -s -f '$url' >/dev/null"
+}
+
+# Test Mermaid script loading
+test_mermaid_script() {
+    local url="$1"
+    local description="$2"
+    
+    run_test "$description" "curl -s '$url' | grep -q 'mermaid.min.js'"
+}
+
+# Test Mermaid initialization
+test_mermaid_init() {
+    local url="$1"
+    local description="$2"
+    
+    run_test "$description" "curl -s '$url' | grep -q 'mermaid.initialize'"
+}
+
+# Test diagram rendering
+test_diagram_rendering() {
+    local url="$1"
+    local description="$2"
+    
+    run_test "$description" "curl -s '$url' | grep -q 'class=\"mermaid\"'"
+}
+
+# Main test execution
+main() {
+    echo "🧪 Mermaid Integration Test Suite"
+    echo "=================================="
+    echo "Mode: $TEST_MODE"
+    echo "Verbose: $VERBOSE"
+    echo "Quick: $QUICK"
+    echo ""
+    
+    # Core file tests
+    log_info "Testing core files..."
+    
+    test_file_exists "_includes/components/mermaid.html" "Mermaid include file exists"
+    test_file_exists "pages/_docs/jekyll/mermaid.md" "Main documentation exists"
+    test_file_exists "pages/_docs/jekyll/mermaid-test-suite.md" "Test suite exists"
+    test_file_exists "pages/_docs/jekyll/jekyll-diagram-with-mermaid.md" "Tutorial exists"
+    
+    # Configuration tests
+    log_info "Testing configuration..."
+    
+    test_file_content "_config.yml" "jekyll-mermaid" "Jekyll-mermaid plugin configured"
+    test_file_content "_config.yml" "mermaid:" "Mermaid configuration present"
+    test_file_content "_includes/core/head.html" "page.mermaid" "Conditional loading configured"
+    test_file_content "_includes/core/head.html" "mermaid.html" "Mermaid include referenced"
+    
+    # Mermaid include file tests
+    log_info "Testing Mermaid include file..."
+    
+    test_file_content "_includes/components/mermaid.html" "mermaid@10" "Mermaid v10 CDN link"
+    test_file_content "_includes/components/mermaid.html" "mermaid.initialize" "Mermaid initialization script"
+    test_file_content "_includes/components/mermaid.html" "forest" "Forest theme configured"
+    test_file_content "_includes/components/mermaid.html" "FontAwesome" "FontAwesome support included"
+    
+    # Documentation tests
+    log_info "Testing documentation..."
+    
+    test_file_content "pages/_docs/jekyll/mermaid.md" "mermaid: true" "Main docs have front matter"
+    test_file_content "pages/_docs/jekyll/mermaid-test-suite.md" "mermaid: true" "Test suite has front matter"
+    test_file_content "pages/_docs/jekyll/mermaid.md" "graph TD" "Main docs have examples"
+    test_file_content "pages/_docs/jekyll/mermaid-test-suite.md" "graph TD" "Test suite has examples"
+    
+    # Server tests (if not quick mode)
+    if [ "$QUICK" = false ]; then
+        log_info "Testing server functionality..."
+        
+        # Test local server if enabled
+        if [ "$TEST_MODE" = "local" ] || [ "$TEST_MODE" = "both" ]; then
+            log_info "Testing local Jekyll server..."
+            
+            # Check if local server is running
+            if curl -s -f "http://localhost:4000" >/dev/null 2>&1; then
+                test_url "http://localhost:4000/docs/jekyll/mermaid/" "Main documentation accessible"
+                test_url "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Test suite accessible"
+                test_mermaid_script "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Mermaid script loads on test page"
+                test_mermaid_init "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Mermaid initializes on test page"
+                test_diagram_rendering "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Diagrams render on test page"
+            else
+                log_warning "Local Jekyll server not running. Start with: bundle exec jekyll serve"
+            fi
+        fi
+        
+        # Test Docker server if enabled
+        if [ "$TEST_MODE" = "docker" ] || [ "$TEST_MODE" = "both" ]; then
+            log_info "Testing Docker container..."
+            
+            # Check if Docker container is running
+            if docker ps | grep -q "zer0-mistakes-jekyll"; then
+                test_url "http://localhost:4000/docs/jekyll/mermaid/" "Docker: Main documentation accessible"
+                test_url "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Test suite accessible"
+                test_mermaid_script "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Mermaid script loads"
+                test_mermaid_init "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Mermaid initializes"
+                test_diagram_rendering "http://localhost:4000/docs/jekyll/mermaid-test-suite/" "Docker: Diagrams render"
+            else
+                log_warning "Docker container not running. Start with: docker-compose up -d"
+            fi
+        fi
+    fi
+    
+    # Summary
+    echo ""
+    echo "📊 Test Results Summary"
+    echo "======================"
+    echo "Total Tests: $TOTAL_TESTS"
+    echo "Passed: $TESTS_PASSED"
+    echo "Failed: $TESTS_FAILED"
+    
+    if [ $TESTS_FAILED -eq 0 ]; then
+        log_success "All tests passed! ✅"
+        exit 0
+    else
+        log_error "Some tests failed! ❌"
+        exit 1
+    fi
+}
+
+# Run main function
+main "$@"

data/scripts/test/lib/run_tests.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+
+# Test runner for library unit tests
+# Usage: ./scripts/test/lib/run_tests.sh
+#
+# Note: Requires Bash 4.0+ (for associative arrays in changelog.sh)
+# On macOS: brew install bash
+
+# Note: We intentionally don't use set -e here because test assertions 
+# may return non-zero and we want to continue running tests
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Navigate from scripts/test/lib to scripts/lib
+LIB_DIR="$(cd "$SCRIPT_DIR/../../lib" && pwd)"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Test counters
+TESTS_RUN=0
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+# Test result tracking
+declare -a FAILED_TESTS=()
+
+# Test assertions
+assert_equals() {
+    local expected="$1"
+    local actual="$2"
+    local message="${3:-}"
+    
+    ((TESTS_RUN++))
+    
+    if [[ "$expected" == "$actual" ]]; then
+        ((TESTS_PASSED++))
+        echo -e "${GREEN}✓${NC} $message"
+        return 0
+    else
+        ((TESTS_FAILED++))
+        echo -e "${RED}✗${NC} $message"
+        echo -e "  Expected: ${YELLOW}$expected${NC}"
+        echo -e "  Actual:   ${YELLOW}$actual${NC}"
+        FAILED_TESTS+=("$message")
+        return 1
+    fi
+}
+
+assert_true() {
+    local condition="$1"
+    local message="${2:-}"
+    
+    ((TESTS_RUN++))
+    
+    if eval "$condition"; then
+        ((TESTS_PASSED++))
+        echo -e "${GREEN}✓${NC} $message"
+        return 0
+    else
+        ((TESTS_FAILED++))
+        echo -e "${RED}✗${NC} $message"
+        echo -e "  Condition failed: ${YELLOW}$condition${NC}"
+        FAILED_TESTS+=("$message")
+        return 1
+    fi
+}
+
+assert_false() {
+    local condition="$1"
+    local message="${2:-}"
+    
+    ((TESTS_RUN++))
+    
+    if ! eval "$condition"; then
+        ((TESTS_PASSED++))
+        echo -e "${GREEN}✓${NC} $message"
+        return 0
+    else
+        ((TESTS_FAILED++))
+        echo -e "${RED}✗${NC} $message"
+        echo -e "  Condition should have failed: ${YELLOW}$condition${NC}"
+        FAILED_TESTS+=("$message")
+        return 1
+    fi
+}
+
+# Test suite header
+print_suite_header() {
+    echo -e "\n${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}Testing: $1${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}\n"
+}
+
+# Run test files
+run_test_file() {
+    local test_file="$1"
+    
+    if [[ -f "$test_file" && -x "$test_file" ]]; then
+        bash "$test_file"
+    else
+        echo -e "${YELLOW}Skipping $test_file (not found or not executable)${NC}"
+    fi
+}
+
+# Main test execution
+main() {
+    echo -e "${BLUE}╔═══════════════════════════════════════╗${NC}"
+    echo -e "${BLUE}║   Library Unit Test Suite            ║${NC}"
+    echo -e "${BLUE}╚═══════════════════════════════════════╝${NC}"
+    
+    # Save the test directory (test files may overwrite SCRIPT_DIR)
+    local TEST_DIR="$SCRIPT_DIR"
+    
+    # Export test functions for use in test files
+    export -f assert_equals assert_true assert_false print_suite_header
+    export RED GREEN YELLOW BLUE NC
+    export LIB_DIR
+    
+    # Run individual test files (sourced, not executed)
+    source "$TEST_DIR/test_version.sh"
+    source "$TEST_DIR/test_validation.sh"
+    source "$TEST_DIR/test_git.sh"
+    source "$TEST_DIR/test_changelog.sh"
+    source "$TEST_DIR/test_gem.sh"
+    
+    # Summary
+    echo -e "\n${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}Test Summary${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "Total:  $TESTS_RUN"
+    echo -e "${GREEN}Passed: $TESTS_PASSED${NC}"
+    echo -e "${RED}Failed: $TESTS_FAILED${NC}"
+    
+    if [[ $TESTS_FAILED -gt 0 ]]; then
+        echo -e "\n${RED}Failed tests:${NC}"
+        for test in "${FAILED_TESTS[@]}"; do
+            echo -e "  ${RED}✗${NC} $test"
+        done
+        exit 1
+    else
+        echo -e "\n${GREEN}All tests passed! 🎉${NC}"
+        exit 0
+    fi
+}
+
+main "$@"