jekyll-theme-zer0 0.7.2 → 0.8.1

data/scripts/test-auto-version.sh

@@ -0,0 +1,260 @@
+#!/bin/bash
+
+# Test Script for Automated Version Bump System
+# Tests the commit analysis and version bump automation
+# Usage: ./scripts/test-auto-version.sh
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Logging functions
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_test() {
+    echo -e "${CYAN}[TEST]${NC} $1"
+}
+
+# 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-mermaid.sh

@@ -0,0 +1,251 @@
+#!/bin/bash
+
+###############################################################################
+# Mermaid Integration Test Script
+# 
+# Purpose: Comprehensive testing of Mermaid.js integration in Jekyll
+# Usage: ./test-mermaid.sh [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
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Test counters
+TESTS_PASSED=0
+TESTS_FAILED=0
+TOTAL_TESTS=0
+
+# Configuration
+VERBOSE=false
+HEADLESS=false
+QUICK=false
+TEST_MODE="both"  # local, docker, both
+
+# Parse arguments
+for arg in "$@"; do
+  case $arg in
+    --verbose)
+      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.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+
+# Test script for zer0-mistakes Jekyll theme
+# Usage: ./scripts/test.sh [--verbose]
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Default values
+VERBOSE=false
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --verbose|-v)
+            VERBOSE=true
+            shift
+            ;;
+        *)
+            echo -e "${RED}Unknown option: $1${NC}"
+            exit 1
+            ;;
+    esac
+done
+
+# Function to log messages
+log() {
+    echo -e "${GREEN}[TEST]${NC} $1"
+}
+
+warn() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+    exit 1
+}
+
+info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+fail() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+# Test counter
+TESTS_RUN=0
+TESTS_PASSED=0
+
+run_test() {
+    local test_name="$1"
+    local test_command="$2"
+    
+    TESTS_RUN=$((TESTS_RUN + 1))
+    
+    log "Running: $test_name"
+    
+    if [[ "$VERBOSE" == true ]]; then
+        echo "Command: $test_command"
+    fi
+    
+    if eval "$test_command" > /dev/null 2>&1; then
+        success "$test_name"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+    else
+        fail "$test_name"
+        if [[ "$VERBOSE" == true ]]; then
+            echo "Command output:"
+            eval "$test_command" 2>&1 || true
+        fi
+    fi
+}
+
+log "Running tests for zer0-mistakes Jekyll theme..."
+
+# Test 1: Validate package.json
+run_test "Validate package.json syntax" "jq empty package.json"
+
+# Test 2: Validate package.json version
+run_test "Validate package.json version format" "jq -r '.version' package.json | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$'"
+
+# Test 3: Validate gemspec syntax
+run_test "Validate gemspec syntax" "ruby -c jekyll-theme-zer0.gemspec"
+
+# Test 4: Build gem (test build)
+run_test "Test gem build" "gem build jekyll-theme-zer0.gemspec"
+
+# Test 5: Check for required files
+run_test "Check README.md exists" "test -f README.md"
+run_test "Check LICENSE exists" "test -f LICENSE"
+run_test "Check _layouts directory exists" "test -d _layouts"
+run_test "Check _includes directory exists" "test -d _includes"
+run_test "Check _sass directory exists" "test -d _sass"
+run_test "Check assets directory exists" "test -d assets"
+
+# Test 6: Validate YAML front matter in layouts
+if [[ -d "_layouts" ]]; then
+    for layout in _layouts/*.html; do
+        if [[ -f "$layout" ]]; then
+            layout_name=$(basename "$layout")
+            run_test "Validate YAML front matter in $layout_name" "head -10 '$layout' | grep -q -- '---' && head -10 '$layout' | tail -n +2 | head -n -1 | ruby -ryaml -e 'YAML.load(STDIN.read)'"
+        fi
+    done
+fi
+
+# Test 7: Check for common Jekyll requirements
+run_test "Check Jekyll dependency in gemspec" "grep -q 'jekyll' jekyll-theme-zer0.gemspec"
+
+# Test 8: Validate version consistency
+PACKAGE_VERSION=$(jq -r '.version' package.json)
+if [[ -f "jekyll-theme-zer0-${PACKAGE_VERSION}.gem" ]]; then
+    run_test "Version consistency check" "test -f jekyll-theme-zer0-${PACKAGE_VERSION}.gem"
+fi
+
+# Test 9: Check scripts are executable
+if [[ -d "scripts" ]]; then
+    for script in scripts/*.sh; do
+        if [[ -f "$script" ]]; then
+            script_name=$(basename "$script")
+            run_test "Check $script_name is executable" "test -x '$script'"
+        fi
+    done
+fi
+
+# Test 10: Validate bundle install
+run_test "Test bundle install" "bundle install --quiet"
+
+# Clean up test gem file
+rm -f jekyll-theme-zer0-*.gem 2>/dev/null || true
+
+# Test results
+log ""
+log "Test Results:"
+log "Tests run: $TESTS_RUN"
+log "Tests passed: $TESTS_PASSED"
+log "Tests failed: $((TESTS_RUN - TESTS_PASSED))"
+
+if [[ $TESTS_PASSED -eq $TESTS_RUN ]]; then
+    success "All tests passed!"
+    exit 0
+else
+    fail "Some tests failed!"
+    exit 1
+fi