jekyll-theme-zer0 0.8.1 → 0.10.0

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 "$@"

data/scripts/test/lib/test_changelog.sh

@@ -0,0 +1,90 @@
+#!/bin/bash
+
+# Unit tests for changelog.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(cd "$SCRIPT_DIR/../../lib" && pwd)"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/changelog.sh"
+
+# Disable errexit for test assertions
+set +e
+
+print_suite_header "changelog.sh"
+
+# Test: clean_commit_message
+echo "Testing clean_commit_message..."
+
+result=$(clean_commit_message "feat: add new feature")
+assert_equals "Add new feature" "$result" "Clean 'feat:' prefix"
+
+result=$(clean_commit_message "fix: resolve bug")
+assert_equals "Resolve bug" "$result" "Clean 'fix:' prefix"
+
+result=$(clean_commit_message "feat(scope): add scoped feature")
+assert_equals "Add scoped feature" "$result" "Clean 'feat(scope):' prefix"
+
+result=$(clean_commit_message "chore: update dependencies")
+assert_equals "Update dependencies" "$result" "Clean 'chore:' prefix"
+
+result=$(clean_commit_message "docs: improve readme")
+assert_equals "Improve readme" "$result" "Clean 'docs:' prefix and capitalize"
+
+result=$(clean_commit_message "regular commit message")
+assert_equals "Regular commit message" "$result" "Capitalize regular message"
+
+# Test: categorize_commit (requires git, so we test the logic patterns)
+echo -e "\nTesting commit categorization patterns..."
+
+# Simulate commit subjects for categorization
+test_categorization() {
+    local subject="$1"
+    local expected="$2"
+    
+    # Create temporary test function that returns category based on patterns
+    local subject_lower=$(echo "$subject" | tr '[:upper:]' '[:lower:]')
+    local category="other"
+    
+    case "$subject_lower" in
+        feat:*|feature:*|add:*|new:*)
+            category="added"
+            ;;
+        fix:*|bugfix:*|bug:*|patch:*)
+            category="fixed"
+            ;;
+        *breaking*)
+            category="breaking"
+            ;;
+        perf:*|performance:*|refactor:*|style:*|docs:*|doc:*|test:*|chore:*|ci:*|build:*)
+            category="changed"
+            ;;
+        revert:*|remove:*|delete:*)
+            category="removed"
+            ;;
+        deprecate:*|deprecated:*)
+            category="deprecated"
+            ;;
+        security:*|sec:*)
+            category="security"
+            ;;
+    esac
+    
+    assert_equals "$expected" "$category" "Categorize: '$subject' → $expected"
+}
+
+test_categorization "feat: new feature" "added"
+test_categorization "fix: bug fix" "fixed"
+test_categorization "chore: update" "changed"
+test_categorization "docs: improve" "changed"
+test_categorization "remove: old code" "removed"
+test_categorization "security: patch vulnerability" "security"
+test_categorization "BREAKING: major change" "breaking"
+test_categorization "random commit" "other"
+
+echo -e "\n${GREEN}changelog.sh tests complete${NC}"

data/scripts/test/lib/test_gem.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+
+# Unit tests for gem.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(cd "$SCRIPT_DIR/../../lib" && pwd)"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/gem.sh"
+
+# Disable errexit for test assertions
+set +e
+
+print_suite_header "gem.sh"
+
+# Test: gem_version_exists
+echo "Testing gem_version_exists..."
+
+# Test with a version that should exist (v1.0.0 is common)
+if gem_version_exists "1.0.0" 2>/dev/null; then
+    echo -e "${YELLOW}ℹ${NC} Version 1.0.0 exists on RubyGems"
+else
+    echo -e "${YELLOW}ℹ${NC} Version 1.0.0 does not exist on RubyGems"
+fi
+
+# Test with a version that definitely shouldn't exist
+if gem_version_exists "999.999.999" 2>/dev/null; then
+    assert_false "true" "Non-existent version not found"
+else
+    assert_false "false" "Non-existent version not found"
+fi
+
+# Test: Gem operations (dry run)
+echo -e "\nTesting gem operations in dry run mode..."
+
+# Test build_gem in dry run
+if build_gem "1.0.0" 2>/dev/null; then
+    assert_true "true" "Dry run: build_gem"
+else
+    assert_true "false" "Dry run: build_gem"
+fi
+
+# Test publish_gem in dry run  
+if publish_gem "1.0.0" 2>/dev/null; then
+    assert_true "true" "Dry run: publish_gem"
+else
+    # May fail due to missing gem file, that's ok in dry run
+    echo -e "${YELLOW}ℹ${NC} Dry run: publish_gem (skipped - no gem file)"
+fi
+
+# Test create_github_release in dry run
+if create_github_release "1.0.0" 2>/dev/null; then
+    assert_true "true" "Dry run: create_github_release"
+else
+    # May fail if gh CLI not available, that's ok
+    echo -e "${YELLOW}ℹ${NC} Dry run: create_github_release (skipped - gh CLI may not be available)"
+fi
+
+# Test run_tests in dry run
+if run_tests 2>/dev/null; then
+    assert_true "true" "Dry run: run_tests"
+else
+    assert_true "false" "Dry run: run_tests"
+fi
+
+echo -e "\n${GREEN}gem.sh tests complete${NC}"

data/scripts/test/lib/test_git.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+
+# Unit tests for git.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(cd "$SCRIPT_DIR/../../lib" && pwd)"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/git.sh"
+
+# Disable errexit for test assertions
+set +e
+
+print_suite_header "git.sh"
+
+# Test: get_current_branch
+echo "Testing get_current_branch..."
+
+current_branch=$(get_current_branch)
+if [[ -n "$current_branch" ]]; then
+    assert_true "true" "Get current branch: $current_branch"
+else
+    assert_true "false" "Get current branch"
+fi
+
+# Test: get_remote_url
+echo -e "\nTesting get_remote_url..."
+
+remote_url=$(get_remote_url "origin" 2>/dev/null)
+if [[ -n "$remote_url" ]]; then
+    assert_true "true" "Get remote URL: $remote_url"
+else
+    echo -e "${YELLOW}ℹ${NC} No remote URL found (may not be in git repo)"
+fi
+
+# Test: get_repo_info
+echo -e "\nTesting get_repo_info..."
+
+if [[ -n "$remote_url" ]]; then
+    repo_info=$(get_repo_info "origin" 2>/dev/null)
+    if [[ -n "$repo_info" ]]; then
+        assert_true "true" "Extract repo info: $repo_info"
+    else
+        echo -e "${YELLOW}ℹ${NC} Could not extract repo info from URL"
+    fi
+fi
+
+# Test: tag_exists
+echo -e "\nTesting tag_exists..."
+
+# Test with a tag that likely doesn't exist
+if tag_exists "v999.999.999"; then
+    assert_false "true" "Non-existent tag not found"
+else
+    assert_false "false" "Non-existent tag not found"
+fi
+
+# Test: get_last_version_tag
+echo -e "\nTesting get_last_version_tag..."
+
+last_tag=$(get_last_version_tag 2>/dev/null)
+if [[ -n "$last_tag" ]]; then
+    assert_true "true" "Get last version tag: $last_tag"
+else
+    echo -e "${YELLOW}ℹ${NC} No version tags found (using initial commit)"
+fi
+
+# Test: count_commits_since
+echo -e "\nTesting count_commits_since..."
+
+if [[ -n "$last_tag" ]]; then
+    commit_count=$(count_commits_since "$last_tag" 2>/dev/null)
+    if [[ "$commit_count" =~ ^[0-9]+$ ]]; then
+        assert_true "true" "Count commits since $last_tag: $commit_count"
+    else
+        assert_true "false" "Count commits returns number"
+    fi
+fi
+
+echo -e "\n${GREEN}git.sh tests complete${NC}"