jekyll-theme-zer0 0.7.2 → 0.10.0

data/scripts/bin/test

@@ -0,0 +1,203 @@
+#!/bin/bash
+
+# Unified test runner for zer0-mistakes Jekyll theme
+# Usage: ./scripts/bin/test [options]
+#
+# Runs all test suites: library tests, theme tests, and integration tests.
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPTS_ROOT="$SCRIPT_DIR/.."
+LIB_DIR="$SCRIPTS_ROOT/lib"
+TEST_DIR="$SCRIPTS_ROOT/test"
+
+# Source common library for logging
+source "$LIB_DIR/common.sh"
+
+# Aliases for consistent function naming
+log_info() { info "$@"; }
+log_success() { success "$@"; }
+log_warning() { warn "$@"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $@" >&2; }
+
+# Show usage
+show_usage() {
+    cat << EOF
+🧪 Unified Test Runner for zer0-mistakes
+
+USAGE:
+    ./scripts/bin/test [OPTIONS] [TEST_SUITE]
+
+TEST SUITES:
+    all         Run all tests (default)
+    lib         Run library unit tests only
+    theme       Run theme validation tests only
+    integration Run integration tests only
+
+OPTIONS:
+    --verbose, -v    Show detailed test output
+    --dry-run        Preview what tests would run
+    --help, -h       Show this help message
+
+EXAMPLES:
+    ./scripts/bin/test              # Run all tests
+    ./scripts/bin/test lib          # Run library tests only
+    ./scripts/bin/test --verbose    # Run all tests with verbose output
+
+TEST LOCATIONS:
+    Library tests:     scripts/test/lib/
+    Theme tests:       scripts/test/theme/
+    Integration tests: scripts/test/integration/
+EOF
+}
+
+# Parse arguments
+TEST_SUITE="all"
+for arg in "$@"; do
+    case $arg in
+        --help|-h)
+            show_usage
+            exit 0
+            ;;
+        --verbose|-v)
+            export VERBOSE=true
+            ;;
+        --dry-run)
+            export DRY_RUN=true
+            ;;
+        all|lib|theme|integration)
+            TEST_SUITE="$arg"
+            ;;
+        *)
+            error "Unknown option: $arg (use --help for usage)"
+            ;;
+    esac
+done
+
+# Track test results
+TOTAL_TESTS=0
+TOTAL_PASSED=0
+TOTAL_FAILED=0
+
+# Run library tests
+run_lib_tests() {
+    log_info "Running library unit tests..."
+    
+    if [[ -f "$TEST_DIR/lib/run_tests.sh" ]]; then
+        # Use current bash interpreter to ensure bash 4+ features work
+        if "$BASH" "$TEST_DIR/lib/run_tests.sh"; then
+            log_success "Library tests passed"
+            ((TOTAL_PASSED++)) || true
+        else
+            log_error "Library tests failed"
+            ((TOTAL_FAILED++)) || true
+        fi
+        ((TOTAL_TESTS++)) || true
+    else
+        log_warning "Library test runner not found at $TEST_DIR/lib/run_tests.sh"
+    fi
+}
+
+# Run theme validation tests
+run_theme_tests() {
+    log_info "Running theme validation tests..."
+    
+    # Check for theme test script (will be migrated here)
+    if [[ -f "$TEST_DIR/theme/validate" ]]; then
+        if "$TEST_DIR/theme/validate"; then
+            log_success "Theme tests passed"
+            ((TOTAL_PASSED++)) || true
+        else
+            log_error "Theme tests failed"
+            ((TOTAL_FAILED++)) || true
+        fi
+        ((TOTAL_TESTS++)) || true
+    else
+        # Fall back to legacy test.sh in scripts root
+        if [[ -f "$SCRIPTS_ROOT/test.sh" ]]; then
+            log_warning "Using legacy test.sh (will be migrated to test/theme/)"
+            if "$SCRIPTS_ROOT/test.sh"; then
+                log_success "Theme tests passed"
+                ((TOTAL_PASSED++)) || true
+            else
+                log_error "Theme tests failed"
+                ((TOTAL_FAILED++)) || true
+            fi
+            ((TOTAL_TESTS++)) || true
+        else
+            log_warning "Theme tests not found"
+        fi
+    fi
+}
+
+# Run integration tests
+run_integration_tests() {
+    log_info "Running integration tests..."
+    
+    local found_tests=false
+    
+    for test_file in "$TEST_DIR/integration"/*; do
+        if [[ -f "$test_file" && -x "$test_file" ]]; then
+            found_tests=true
+            local test_name
+            test_name=$(basename "$test_file")
+            log_info "Running integration test: $test_name"
+            
+            if "$test_file"; then
+                log_success "$test_name passed"
+                ((TOTAL_PASSED++)) || true
+            else
+                log_error "$test_name failed"
+                ((TOTAL_FAILED++)) || true
+            fi
+            ((TOTAL_TESTS++)) || true
+        fi
+    done
+    
+    if [[ "$found_tests" == "false" ]]; then
+        log_warning "No integration tests found in $TEST_DIR/integration/"
+    fi
+}
+
+# Main execution
+log_info "🧪 Starting test suite: $TEST_SUITE"
+echo ""
+
+case $TEST_SUITE in
+    all)
+        run_lib_tests
+        echo ""
+        run_theme_tests
+        echo ""
+        run_integration_tests
+        ;;
+    lib)
+        run_lib_tests
+        ;;
+    theme)
+        run_theme_tests
+        ;;
+    integration)
+        run_integration_tests
+        ;;
+esac
+
+# Summary
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+log_info "Test Summary"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Total test suites: $TOTAL_TESTS"
+echo "  Passed: $TOTAL_PASSED"
+echo "  Failed: $TOTAL_FAILED"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [[ $TOTAL_FAILED -gt 0 ]]; then
+    log_error "Some tests failed!"
+    exit 1
+else
+    log_success "All tests passed!"
+    exit 0
+fi

data/scripts/build

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Simplified build command for zer0-mistakes Jekyll theme
+# Usage: ./scripts/build [options]
+#
+# Quick gem building without the full release workflow.
+
+set -euo pipefail
+
+# Get script and library directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/lib"
+
+# Source required libraries
+source "$LIB_DIR/common.sh"
+source "$LIB_DIR/validation.sh"
+source "$LIB_DIR/version.sh"
+source "$LIB_DIR/gem.sh"
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            export DRY_RUN=true
+            shift
+            ;;
+        --verbose)
+            export VERBOSE=true
+            shift
+            ;;
+        --help|-h)
+            show_usage
+            exit 0
+            ;;
+        *)
+            error "Unknown option: $1 (use --help for usage)"
+            ;;
+    esac
+done
+
+# Show usage
+show_usage() {
+    cat << EOF
+🔨 Simplified Build Command for zer0-mistakes
+
+USAGE:
+    ./scripts/build [OPTIONS]
+
+DESCRIPTION:
+    Builds the Jekyll theme gem without running the full release workflow.
+    Useful for testing gem packaging or preparing for manual publication.
+
+OPTIONS:
+    --dry-run     Preview build without creating files
+    --verbose     Show detailed debug output
+    --help, -h    Show this help message
+
+EXAMPLES:
+    ./scripts/build                # Build gem with current version
+    ./scripts/build --dry-run      # Preview what would be built
+    ./scripts/build --verbose      # Build with debug output
+
+ENVIRONMENT VARIABLES:
+    DRY_RUN=true     Enable dry run mode
+    VERBOSE=true     Enable debug output
+
+OUTPUT:
+    Creates: jekyll-theme-zer0-VERSION.gem in current directory
+
+For full release workflow, use: ./scripts/release
+EOF
+}
+
+# Main build workflow
+main() {
+    print_header "🔨 Gem Build"
+    
+    # Step 1: Basic validation (no RubyGems auth needed for build)
+    step "Validating environment..."
+    validate_git_repo
+    validate_required_files
+    validate_gemspec
+    success "Environment validated"
+    echo ""
+    
+    # Step 2: Get current version
+    step "Reading version..."
+    local version
+    version=$(get_current_version)
+    info "Current version: $version"
+    info "Gem file: jekyll-theme-zer0-${version}.gem"
+    echo ""
+    
+    # Step 3: Build gem
+    build_gem "$version"
+    echo ""
+    
+    # Success summary
+    if [[ "$DRY_RUN" != "true" ]]; then
+        print_summary "Build Complete" \
+            "✅ Built: jekyll-theme-zer0-${version}.gem" \
+            "" \
+            "Next steps:" \
+            "  • Test: gem install jekyll-theme-zer0-${version}.gem" \
+            "  • Publish: gem push jekyll-theme-zer0-${version}.gem" \
+            "  • Or use: ./scripts/release for full workflow"
+    else
+        info "Dry run complete - no files created"
+    fi
+    
+    success "Build completed successfully!"
+}
+
+# Run main function
+main "$@"

data/scripts/example-usage.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+
+# Example script demonstrating library usage
+# This shows how simple release workflows become with the new libraries
+
+set -euo pipefail
+
+# Get library directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/lib"
+
+# Source all libraries
+source "$LIB_DIR/common.sh"
+source "$LIB_DIR/validation.sh"
+source "$LIB_DIR/version.sh"
+source "$LIB_DIR/git.sh"
+source "$LIB_DIR/changelog.sh"
+source "$LIB_DIR/gem.sh"
+
+# Configuration
+export DRY_RUN=true
+export INTERACTIVE=false
+
+# Main demonstration
+main() {
+    print_header "Library Usage Example"
+    
+    echo -e "${CYAN}This example shows how the new libraries work together.${NC}"
+    echo -e "${CYAN}Running in DRY_RUN mode (no actual changes made).${NC}"
+    echo ""
+    
+    # Step 1: Validation
+    step "Step 1: Environment Validation"
+    validate_git_repo
+    validate_required_files
+    validate_dependencies
+    echo ""
+    
+    # Step 2: Version Management
+    step "Step 2: Version Management"
+    current_version=$(get_current_version)
+    info "Current version: $current_version"
+    
+    new_version=$(calculate_new_version "$current_version" "minor")
+    info "Next version would be: $new_version"
+    echo ""
+    
+    # Step 3: Git Operations
+    step "Step 3: Git Information"
+    last_tag=$(get_last_version_tag)
+    info "Last version tag: $last_tag"
+    
+    commit_count=$(count_commits_since "$last_tag")
+    info "Commits since last tag: $commit_count"
+    
+    current_branch=$(get_current_branch)
+    info "Current branch: $current_branch"
+    echo ""
+    
+    # Step 4: Changelog Preview
+    step "Step 4: Changelog Generation"
+    info "Analyzing commits for changelog..."
+    
+    commits=$(get_commits_between "$last_tag" "HEAD" | head -5)
+    if [[ -n "$commits" ]]; then
+        echo -e "${PURPLE}Recent commits:${NC}"
+        while IFS='|' read -r hash subject author date; do
+            [[ -z "$hash" ]] && continue
+            echo "  - $subject"
+        done <<< "$commits"
+    fi
+    echo ""
+    
+    # Step 5: Gem Operations (dry run)
+    step "Step 5: Gem Operations Preview"
+    info "Would build: jekyll-theme-zer0-${new_version}.gem"
+    info "Would run: bundle exec rspec"
+    info "Would publish to: https://rubygems.org/gems/jekyll-theme-zer0"
+    echo ""
+    
+    # Summary
+    print_summary "Example Complete" \
+        "✅ Environment validated" \
+        "✅ Version calculated: $current_version → $new_version" \
+        "✅ Git information retrieved" \
+        "✅ Changelog preview generated" \
+        "✅ Gem operations previewed"
+    
+    success "All library functions working correctly!"
+    
+    echo ""
+    echo -e "${CYAN}To actually perform a release, use:${NC}"
+    echo -e "  ${YELLOW}./scripts/release minor${NC}"
+    echo ""
+    echo -e "${CYAN}To learn more about the libraries:${NC}"
+    echo -e "  ${YELLOW}cat scripts/lib/README.md${NC}"
+}
+
+# Run if executed directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi