jekyll-theme-zer0 0.7.2 → 0.8.1

data/scripts/lib/test/run_tests.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+
+# Test runner for library unit tests
+# Usage: ./scripts/lib/test/run_tests.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(dirname "$SCRIPT_DIR")"
+
+# 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}"
+    
+# 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 "$SCRIPT_DIR/test_version.sh"
+source "$SCRIPT_DIR/test_validation.sh"
+source "$SCRIPT_DIR/test_git.sh"
+source "$SCRIPT_DIR/test_changelog.sh"
+source "$SCRIPT_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/lib/test/test_changelog.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+
+# Unit tests for changelog.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/changelog.sh"
+
+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/lib/test/test_gem.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+
+# Unit tests for gem.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/gem.sh"
+
+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/lib/test/test_git.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+
+# Unit tests for git.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/git.sh"
+
+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}"

data/scripts/lib/test/test_validation.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+
+# Unit tests for validation.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/validation.sh"
+
+print_suite_header "validation.sh"
+
+# Test: validate_git_repo (should pass since we're in a git repo)
+echo "Testing validate_git_repo..."
+
+if validate_git_repo 2>/dev/null; then
+    assert_true "true" "Detects git repository"
+else
+    assert_true "false" "Detects git repository"
+fi
+
+# Test: validate_required_files
+echo -e "\nTesting validate_required_files..."
+
+# This will fail if we're not in the project root, but that's expected for tests
+if validate_required_files 2>/dev/null; then
+    assert_true "true" "Required files exist"
+else
+    # If files don't exist (running from test dir), that's ok for unit tests
+    echo -e "${YELLOW}ℹ${NC} Required files check skipped (not in project root)"
+fi
+
+# Test: command_exists (from common.sh)
+echo -e "\nTesting command_exists..."
+
+if command_exists "git"; then
+    assert_true "true" "Git command exists"
+else
+    assert_true "false" "Git command exists"
+fi
+
+if command_exists "bash"; then
+    assert_true "true" "Bash command exists"
+else
+    assert_true "false" "Bash command exists"
+fi
+
+if command_exists "nonexistent_command_xyz"; then
+    assert_false "true" "Nonexistent command not found"
+else
+    assert_false "false" "Nonexistent command not found"
+fi
+
+# Test: validate_dependencies
+echo -e "\nTesting validate_dependencies..."
+
+# Test that common dependencies are found
+common_commands=("git" "ruby" "bundle" "jq")
+for cmd in "${common_commands[@]}"; do
+    if command_exists "$cmd"; then
+        assert_true "true" "Required command exists: $cmd"
+    else
+        echo -e "${YELLOW}ℹ${NC} Optional command not found: $cmd (skipping)"
+    fi
+done
+
+echo -e "\n${GREEN}validation.sh tests complete${NC}"

data/scripts/lib/test/test_version.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+
+# Unit tests for version.sh library
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Set up test environment
+export DRY_RUN=true
+export INTERACTIVE=false
+export VERBOSE=false
+
+# Source the library
+source "$LIB_DIR/version.sh"
+
+print_suite_header "version.sh"
+
+# Test: validate_version_format
+echo "Testing validate_version_format..."
+
+valid_versions=("0.0.1" "1.0.0" "10.20.30" "999.999.999")
+for version in "${valid_versions[@]}"; do
+    if validate_version_format "$version" 2>/dev/null; then
+        assert_true "true" "Valid version format accepted: $version"
+    else
+        assert_true "false" "Valid version format accepted: $version"
+    fi
+done
+
+invalid_versions=("1.0" "1.0.0.0" "v1.0.0" "1.0.0-beta" "abc.def.ghi")
+for version in "${invalid_versions[@]}"; do
+    if validate_version_format "$version" 2>/dev/null; then
+        assert_false "true" "Invalid version format rejected: $version"
+    else
+        assert_false "false" "Invalid version format rejected: $version"
+    fi
+done
+
+# Test: calculate_new_version
+echo -e "\nTesting calculate_new_version..."
+
+result=$(calculate_new_version "1.2.3" "patch")
+assert_equals "1.2.4" "$result" "Patch bump: 1.2.3 → 1.2.4"
+
+result=$(calculate_new_version "1.2.3" "minor")
+assert_equals "1.3.0" "$result" "Minor bump: 1.2.3 → 1.3.0"
+
+result=$(calculate_new_version "1.2.3" "major")
+assert_equals "2.0.0" "$result" "Major bump: 1.2.3 → 2.0.0"
+
+result=$(calculate_new_version "0.0.9" "patch")
+assert_equals "0.0.10" "$result" "Patch bump with digit rollover: 0.0.9 → 0.0.10"
+
+result=$(calculate_new_version "0.9.9" "minor")
+assert_equals "0.10.0" "$result" "Minor bump resets patch: 0.9.9 → 0.10.0"
+
+result=$(calculate_new_version "9.9.9" "major")
+assert_equals "10.0.0" "$result" "Major bump resets minor and patch: 9.9.9 → 10.0.0"
+
+# Test: version_less_than
+echo -e "\nTesting version_less_than..."
+
+if version_less_than "1.0.0" "2.0.0"; then
+    assert_true "true" "1.0.0 < 2.0.0"
+else
+    assert_true "false" "1.0.0 < 2.0.0"
+fi
+
+if version_less_than "1.2.3" "1.2.4"; then
+    assert_true "true" "1.2.3 < 1.2.4"
+else
+    assert_true "false" "1.2.3 < 1.2.4"
+fi
+
+if version_less_than "2.0.0" "1.0.0"; then
+    assert_false "true" "2.0.0 not < 1.0.0"
+else
+    assert_false "false" "2.0.0 not < 1.0.0"
+fi
+
+if version_less_than "1.2.3" "1.2.3"; then
+    assert_false "true" "1.2.3 not < 1.2.3 (equal)"
+else
+    assert_false "false" "1.2.3 not < 1.2.3 (equal)"
+fi
+
+# Test: get_version_from_tag
+echo -e "\nTesting get_version_from_tag..."
+
+result=$(get_version_from_tag "v1.2.3")
+assert_equals "1.2.3" "$result" "Remove 'v' prefix: v1.2.3 → 1.2.3"
+
+result=$(get_version_from_tag "1.2.3")
+assert_equals "1.2.3" "$result" "No prefix to remove: 1.2.3 → 1.2.3"
+
+echo -e "\n${GREEN}version.sh tests complete${NC}"

data/scripts/lib/validation.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+
+# Validation library for zer0-mistakes release scripts
+# Provides environment, git, and dependency validation functions
+
+# Source common utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Validate git repository
+validate_git_repo() {
+    debug "Validating git repository..."
+    
+    if ! git rev-parse --git-dir > /dev/null 2>&1; then
+        error "Not in a git repository"
+    fi
+    
+    debug "✓ Git repository validated"
+}
+
+# Validate working directory is clean
+validate_clean_working_dir() {
+    debug "Validating clean working directory..."
+    
+    if [[ -n $(git status --porcelain) ]]; then
+        error "Working directory is not clean. Please commit or stash changes first."
+    fi
+    
+    debug "✓ Working directory is clean"
+}
+
+# Validate required files exist
+validate_required_files() {
+    debug "Validating required files..."
+    
+    local required_files=(
+        "lib/jekyll-theme-zer0/version.rb"
+        "jekyll-theme-zer0.gemspec"
+        "CHANGELOG.md"
+    )
+    
+    for file in "${required_files[@]}"; do
+        require_file "$file"
+    done
+    
+    debug "✓ All required files present"
+}
+
+# Validate required commands
+validate_dependencies() {
+    debug "Validating dependencies..."
+    
+    require_command "git" "Install from https://git-scm.com/"
+    require_command "ruby" "Install from https://www.ruby-lang.org/"
+    require_command "gem" "Comes with Ruby"
+    require_command "bundle" "Install with: gem install bundler"
+    require_command "jq" "Install with: brew install jq (macOS) or apt-get install jq (Linux)"
+    
+    debug "✓ All dependencies available"
+}
+
+# Validate RubyGems authentication
+validate_rubygems_auth() {
+    local skip_publish="${1:-false}"
+    
+    if [[ "$skip_publish" == "true" ]]; then
+        debug "Skipping RubyGems auth validation (publish not required)"
+        return 0
+    fi
+    
+    debug "Validating RubyGems authentication..."
+    
+    if [[ ! -f ~/.gem/credentials ]]; then
+        error "Not authenticated with RubyGems. Run 'gem signin' first."
+    fi
+    
+    debug "✓ RubyGems authentication present"
+}
+
+# Validate gemspec can be parsed
+validate_gemspec() {
+    debug "Validating gemspec..."
+    
+    if ! ruby -c jekyll-theme-zer0.gemspec > /dev/null 2>&1; then
+        error "Invalid gemspec: jekyll-theme-zer0.gemspec"
+    fi
+    
+    debug "✓ Gemspec is valid"
+}
+
+# Validate GitHub CLI availability
+validate_github_cli() {
+    local required="${1:-false}"
+    
+    if command_exists "gh"; then
+        debug "✓ GitHub CLI (gh) available"
+        return 0
+    fi
+    
+    if [[ "$required" == "true" ]]; then
+        error "GitHub CLI (gh) is required. Install from https://cli.github.com/"
+    else
+        warn "GitHub CLI (gh) not found. GitHub releases will be skipped."
+        return 1
+    fi
+}
+
+# Comprehensive environment validation
+validate_environment() {
+    local skip_publish="${1:-false}"
+    local require_gh="${2:-false}"
+    
+    step "Validating environment..."
+    
+    validate_git_repo
+    validate_clean_working_dir
+    validate_required_files
+    validate_dependencies
+    validate_gemspec
+    validate_rubygems_auth "$skip_publish"
+    
+    if [[ "$require_gh" == "true" ]]; then
+        validate_github_cli true
+    else
+        validate_github_cli false
+    fi
+    
+    success "Environment validation complete"
+}
+
+# Export functions
+export -f validate_git_repo
+export -f validate_clean_working_dir
+export -f validate_required_files
+export -f validate_dependencies
+export -f validate_rubygems_auth
+export -f validate_gemspec
+export -f validate_github_cli
+export -f validate_environment