pipecraft 0.0.0-releaseit → 0.26.0

package/tests/github-local/README.md

@@ -1,240 +0,0 @@
-# GitHub Actions Local Testing
-
-This directory contains tests for running GitHub Actions workflows locally using [Act](https://github.com/nektos/act).
-
-## 🎯 Purpose
-
-Local GitHub Actions testing allows us to:
-- Test workflows locally without pushing to GitHub
-- Debug workflow issues in a controlled environment
-- Validate workflow syntax and logic before deployment
-- Test different scenarios and edge cases quickly
-- Iterate on workflow changes without GitHub API limits
-
-## 📁 Structure
-
-```
-tests/github-local/
-├── README.md                 # This file
-├── run-local-tests.sh        # Main test runner script
-├── setup-test-env.sh         # Environment setup script
-├── test-workflows.sh         # Individual workflow testing
-├── fixtures/                  # Test data and configurations
-│   ├── test-configs/         # Test configurations
-│   ├── mock-data/            # Mock data for workflows
-│   └── expected-outputs/     # Expected test outputs
-└── helpers/                  # Test helper scripts
-    ├── act-runner.sh         # Act execution helper
-    └── workflow-validator.sh  # Workflow validation helper
-```
-
-## 🚀 Quick Start
-
-### Prerequisites
-```bash
-# Install Act
-curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
-
-# Or via package manager
-brew install act  # macOS
-choco install act # Windows
-```
-
-### Running Tests
-```bash
-# Run all local tests
-./tests/github-local/run-local-tests.sh
-
-# Test specific workflow
-./tests/github-local/test-workflows.sh --workflow pipeline.yml
-
-# Run with verbose output
-./tests/github-local/run-local-tests.sh --verbose
-
-# Run with debug mode
-./tests/github-local/run-local-tests.sh --debug
-```
-
-## 🔧 Configuration
-
-### Act Configuration
-Create `.actrc` file in project root:
-```yaml
-# Act configuration
--P ubuntu-latest=catthehacker/ubuntu:act-latest
--P ubuntu-20.04=catthehacker/ubuntu:act-20.04
--P ubuntu-18.04=catthehacker/ubuntu:act-18.04
-```
-
-### Test Environment
-```bash
-# Set up test environment
-./tests/github-local/setup-test-env.sh
-
-# This creates:
-# - Test configuration files
-# - Mock GitHub environment
-# - Test data and fixtures
-# - Expected output files
-```
-
-## 📋 Test Workflows
-
-### Supported Workflows
-- **pipeline.yml**: Main workflow orchestration
-- **job.changes.yml**: Change detection workflow
-- **job.version.yml**: Version management workflow
-- **job.tag.yml**: Tag creation workflow
-- **job.createpr.yml**: PR creation workflow
-- **job.branch.yml**: Branch management workflow
-- **job.apps.yml**: Application-specific workflows
-
-### Test Scenarios
-1. **Basic Execution**: Test workflow runs without errors
-2. **Environment Variables**: Test with different env vars
-3. **Conditional Logic**: Test workflow conditions and branches
-4. **Job Dependencies**: Test job dependency chains
-5. **Error Handling**: Test failure scenarios
-6. **Performance**: Test execution time and resource usage
-
-## 🧪 Test Examples
-
-### Basic Workflow Test
-```bash
-# Test main pipeline
-act -W .github/workflows/pipeline.yml --dry-run
-
-# Test with specific event
-act push -W .github/workflows/pipeline.yml --dry-run
-
-# Test with environment variables
-act -W .github/workflows/pipeline.yml --env GITHUB_REF=refs/heads/main --dry-run
-```
-
-### Advanced Testing
-```bash
-# Test with secrets
-act -W .github/workflows/pipeline.yml --secret GITHUB_TOKEN=your_token
-
-# Test with artifacts
-act -W .github/workflows/pipeline.yml --artifact-server-path /tmp/artifacts
-
-# Test with matrix strategy
-act -W .github/workflows/pipeline.yml --matrix os:ubuntu-latest --matrix node:18
-```
-
-## 🔍 Debugging
-
-### Common Issues
-1. **Docker not running**: Ensure Docker is running
-2. **Permission issues**: Check file permissions
-3. **Environment variables**: Verify all required env vars are set
-4. **Workflow syntax**: Check YAML syntax and GitHub Actions syntax
-
-### Debug Commands
-```bash
-# List available workflows
-act --list
-
-# Show workflow details
-act -W .github/workflows/pipeline.yml --list
-
-# Run with verbose output
-act -W .github/workflows/pipeline.yml --verbose
-
-# Run with debug output
-act -W .github/workflows/pipeline.yml --debug
-```
-
-## 📊 Test Results
-
-### Output Format
-```
-✅ Workflow: pipeline.yml
-  ✅ Job: changes (2.3s)
-  ✅ Job: versioning (1.8s)
-  ✅ Job: deployments (4.2s)
-  ⚠️  Job: testing (skipped - no changes)
-
-❌ Workflow: job.changes.yml
-  ❌ Job: changes (failed - missing env var)
-  📝 Error: GITHUB_TOKEN not set
-```
-
-### Performance Metrics
-- **Execution Time**: Track workflow execution time
-- **Resource Usage**: Monitor CPU and memory usage
-- **Job Dependencies**: Validate dependency chains
-- **Error Rates**: Track failure rates and patterns
-
-## 🔄 Continuous Integration
-
-### GitHub Actions Integration
-```yaml
-name: Local Act Tests
-on: [push, pull_request]
-jobs:
-  local-tests:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install Act
-        run: curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
-      - name: Run Local Tests
-        run: ./tests/github-local/run-local-tests.sh
-```
-
-### Local Development
-```bash
-# Watch mode for development
-./tests/github-local/run-local-tests.sh --watch
-
-# Run specific test suite
-./tests/github-local/run-local-tests.sh --suite pipeline
-
-# Run with coverage
-./tests/github-local/run-local-tests.sh --coverage
-```
-
-## 📚 Best Practices
-
-### Test Organization
-1. **Group related tests**: Organize tests by workflow type
-2. **Use fixtures**: Create reusable test data
-3. **Mock external services**: Avoid external dependencies
-4. **Test edge cases**: Include error scenarios and edge cases
-
-### Performance
-1. **Parallel execution**: Run independent tests in parallel
-2. **Resource management**: Monitor Docker resource usage
-3. **Cleanup**: Clean up test artifacts after runs
-4. **Caching**: Use Docker layer caching for faster builds
-
-### Maintenance
-1. **Regular updates**: Keep Act and test dependencies updated
-2. **Documentation**: Document test scenarios and expected outcomes
-3. **Monitoring**: Track test performance and reliability
-4. **Feedback**: Collect feedback from test results
-
-## 🆘 Troubleshooting
-
-### Common Problems
-```bash
-# Act not found
-export PATH=$PATH:/usr/local/bin
-
-# Docker permission denied
-sudo usermod -aG docker $USER
-
-# Workflow syntax errors
-act -W .github/workflows/pipeline.yml --dry-run --verbose
-
-# Environment variable issues
-act -W .github/workflows/pipeline.yml --env-file .env
-```
-
-### Getting Help
-- [Act Documentation](https://github.com/nektos/act)
-- [GitHub Actions Documentation](https://docs.github.com/en/actions)
-- [Docker Documentation](https://docs.docker.com/)
-- [Project Issues](https://github.com/your-org/pipecraft/issues)

package/tests/github-local/run-all-tests.sh

@@ -1,422 +0,0 @@
-#!/bin/bash
-
-# Comprehensive GitHub Actions Testing Suite
-# Runs all GitHub Actions tests using Act
-
-set -euo pipefail
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-PURPLE='\033[0;35m'
-CYAN='\033[0;36m'
-NC='\033[0m' # No Color
-
-# Configuration
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-OUTPUT_DIR="$SCRIPT_DIR/output"
-VERBOSE=false
-DEBUG=false
-CLEANUP=true
-SKIP_JOB_TESTS=false
-SKIP_PIPELINE_TESTS=false
-
-# Function to print colored output
-print_status() {
-    local status=$1
-    local message=$2
-    
-    case $status in
-        "SUCCESS") echo -e "${GREEN}✓${NC} $message" ;;
-        "FAILURE") echo -e "${RED}✗${NC} $message" ;;
-        "WARNING") echo -e "${YELLOW}⚠${NC} $message" ;;
-        "INFO") echo -e "${BLUE}ℹ${NC} $message" ;;
-        "DEBUG") echo -e "${PURPLE}🐛${NC} $message" ;;
-        *) echo -e "${CYAN}?${NC} $message" ;;
-    esac
-}
-
-# Function to show usage
-show_usage() {
-    cat << EOF
-Usage: $0 [OPTIONS]
-
-Comprehensive GitHub Actions Testing Suite
-
-OPTIONS:
-    -j, --skip-job-tests      Skip individual job workflow tests
-    -p, --skip-pipeline-tests Skip pipeline workflow tests
-    -v, --verbose             Verbose output
-    -d, --debug               Debug mode with extra logging
-    -c, --no-cleanup          Don't clean up test artifacts
-    -h, --help                Show this help message
-
-EXAMPLES:
-    $0                                    # Run all tests
-    $0 -j                                # Skip job tests, run pipeline tests
-    $0 -p                                # Skip pipeline tests, run job tests
-    $0 -v -d                             # Verbose debug mode
-    $0 --no-cleanup                      # Run tests, keep artifacts
-
-EOF
-}
-
-# Function to check prerequisites
-check_prerequisites() {
-    print_status "INFO" "Checking prerequisites..."
-    
-    local missing_deps=()
-    
-    # Check for required commands
-    if ! command -v act &> /dev/null; then
-        missing_deps+=("act")
-    fi
-    
-    if ! command -v docker &> /dev/null; then
-        missing_deps+=("docker")
-    fi
-    
-    if ! command -v jq &> /dev/null; then
-        missing_deps+=("jq")
-    fi
-    
-    if [ ${#missing_deps[@]} -gt 0 ]; then
-        print_status "FAILURE" "Missing dependencies: ${missing_deps[*]}"
-        echo -e "${YELLOW}Please install missing dependencies:${NC}"
-        for dep in "${missing_deps[@]}"; do
-            case $dep in
-                "act") echo "  - Act: curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash" ;;
-                "docker") echo "  - Docker: https://docs.docker.com/get-docker/" ;;
-                "jq") echo "  - jq: brew install jq (macOS) or apt-get install jq (Ubuntu)" ;;
-            esac
-        done
-        exit 1
-    fi
-    
-    # Check if Docker is running
-    if ! docker info &> /dev/null; then
-        print_status "FAILURE" "Docker is not running"
-        echo -e "${YELLOW}Please start Docker and try again${NC}"
-        exit 1
-    fi
-    
-    print_status "SUCCESS" "All prerequisites satisfied"
-}
-
-# Function to setup test environment
-setup_test_environment() {
-    print_status "INFO" "Setting up test environment..."
-    
-    # Create output directory
-    mkdir -p "$OUTPUT_DIR"
-    
-    # Create test configuration
-    cat > "$PROJECT_ROOT/.actrc" << EOF
-# Act configuration for testing
--P ubuntu-latest=catthehacker/ubuntu:act-latest
--P ubuntu-20.04=catthehacker/ubuntu:act-20.04
--P ubuntu-18.04=catthehacker/ubuntu:act-18.04
-EOF
-    
-    # Create test environment file
-    cat > "$PROJECT_ROOT/.env" << EOF
-# Test environment variables
-GITHUB_ACTIONS=true
-GITHUB_WORKFLOW=test-workflow
-GITHUB_RUN_ID=123456789
-GITHUB_RUN_NUMBER=1
-GITHUB_ACTOR=test-user
-GITHUB_REPOSITORY=test-org/test-repo
-GITHUB_EVENT_NAME=push
-GITHUB_SHA=abc123def456
-GITHUB_REF=refs/heads/main
-GITHUB_HEAD_REF=""
-GITHUB_BASE_REF=""
-GITHUB_WORKSPACE=$PROJECT_ROOT
-GITHUB_TOKEN=test-token
-EOF
-    
-    print_status "SUCCESS" "Test environment setup complete"
-}
-
-# Function to run job workflow tests
-run_job_tests() {
-    if [ "$SKIP_JOB_TESTS" = true ]; then
-        print_status "WARNING" "Skipping job workflow tests"
-        return 0
-    fi
-    
-    print_status "INFO" "Running job workflow tests..."
-    
-    local test_script="$SCRIPT_DIR/test-job-workflows.sh"
-    if [ ! -f "$test_script" ]; then
-        print_status "FAILURE" "Job test script not found: $test_script"
-        return 1
-    fi
-    
-    local test_args=()
-    if [ "$VERBOSE" = true ]; then
-        test_args+=("-v")
-    fi
-    if [ "$DEBUG" = true ]; then
-        test_args+=("-d")
-    fi
-    if [ "$CLEANUP" = false ]; then
-        test_args+=("-c")
-    fi
-    
-    if "$test_script" "${test_args[@]}"; then
-        print_status "SUCCESS" "Job workflow tests passed"
-        return 0
-    else
-        print_status "FAILURE" "Job workflow tests failed"
-        return 1
-    fi
-}
-
-# Function to run pipeline workflow tests
-run_pipeline_tests() {
-    if [ "$SKIP_PIPELINE_TESTS" = true ]; then
-        print_status "WARNING" "Skipping pipeline workflow tests"
-        return 0
-    fi
-    
-    print_status "INFO" "Running pipeline workflow tests..."
-    
-    local test_script="$SCRIPT_DIR/test-pipeline-workflow.sh"
-    if [ ! -f "$test_script" ]; then
-        print_status "FAILURE" "Pipeline test script not found: $test_script"
-        return 1
-    fi
-    
-    local test_args=()
-    if [ "$VERBOSE" = true ]; then
-        test_args+=("-v")
-    fi
-    if [ "$DEBUG" = true ]; then
-        test_args+=("-d")
-    fi
-    if [ "$CLEANUP" = false ]; then
-        test_args+=("-c")
-    fi
-    
-    if "$test_script" "${test_args[@]}"; then
-        print_status "SUCCESS" "Pipeline workflow tests passed"
-        return 0
-    else
-        print_status "FAILURE" "Pipeline workflow tests failed"
-        return 1
-    fi
-}
-
-# Function to run workflow generation tests
-run_generation_tests() {
-    print_status "INFO" "Running workflow generation tests..."
-    
-    # Check if workflows exist
-    local workflows_dir="$PROJECT_ROOT/.github/workflows"
-    if [ ! -d "$workflows_dir" ]; then
-        print_status "FAILURE" "Workflows directory not found: $workflows_dir"
-        return 1
-    fi
-    
-    # Check for required workflow files
-    local required_workflows=(
-        "pipeline.yml"
-        "job.changes.yml"
-        "job.version.yml"
-        "job.tag.yml"
-        "job.createpr.yml"
-        "job.branch.yml"
-        "job.apps.yml"
-    )
-    
-    local missing_workflows=()
-    for workflow in "${required_workflows[@]}"; do
-        if [ ! -f "$workflows_dir/$workflow" ]; then
-            missing_workflows+=("$workflow")
-        fi
-    done
-    
-    if [ ${#missing_workflows[@]} -gt 0 ]; then
-        print_status "FAILURE" "Missing workflow files: ${missing_workflows[*]}"
-        echo -e "${YELLOW}Please generate workflows first using: ./pipecraft generate${NC}"
-        return 1
-    fi
-    
-    print_status "SUCCESS" "All required workflow files found"
-    return 0
-}
-
-# Function to run syntax validation tests
-run_syntax_tests() {
-    print_status "INFO" "Running workflow syntax validation..."
-    
-    local workflows_dir="$PROJECT_ROOT/.github/workflows"
-    local syntax_errors=0
-    
-    # Check each workflow file for syntax errors
-    find "$workflows_dir" -name "*.yml" -o -name "*.yaml" | while read -r workflow_file; do
-        local workflow_name=$(basename "$workflow_file")
-        
-        # Basic YAML syntax check
-        if ! python3 -c "import yaml; yaml.safe_load(open('$workflow_file'))" 2>/dev/null; then
-            print_status "FAILURE" "Syntax error in $workflow_name"
-            syntax_errors=$((syntax_errors + 1))
-        else
-            print_status "SUCCESS" "Syntax valid: $workflow_name"
-        fi
-    done
-    
-    if [ $syntax_errors -gt 0 ]; then
-        print_status "FAILURE" "Found $syntax_errors syntax errors"
-        return 1
-    else
-        print_status "SUCCESS" "All workflow files have valid syntax"
-        return 0
-    fi
-}
-
-# Function to run all tests
-run_all_tests() {
-    print_status "INFO" "Running comprehensive GitHub Actions test suite..."
-    
-    local failed_tests=0
-    local total_tests=0
-    
-    # Test scenarios
-    local test_scenarios=(
-        "run_generation_tests:Workflow Generation"
-        "run_syntax_tests:Workflow Syntax"
-        "run_job_tests:Job Workflows"
-        "run_pipeline_tests:Pipeline Workflow"
-    )
-    
-    for test in "${test_scenarios[@]}"; do
-        IFS=':' read -r test_function test_name <<< "$test"
-        total_tests=$((total_tests + 1))
-        
-        print_status "INFO" "Running $test_name tests..."
-        if $test_function; then
-            print_status "SUCCESS" "✅ $test_name tests passed"
-        else
-            print_status "FAILURE" "❌ $test_name tests failed"
-            failed_tests=$((failed_tests + 1))
-        fi
-    done
-    
-    # Summary
-    echo ""
-    print_status "INFO" "Test Suite Summary:"
-    echo "  Total test suites: $total_tests"
-    echo "  Passed: $((total_tests - failed_tests))"
-    echo "  Failed: $failed_tests"
-    
-    if [ $failed_tests -gt 0 ]; then
-        print_status "FAILURE" "Some test suites failed"
-        return 1
-    else
-        print_status "SUCCESS" "All test suites passed"
-        return 0
-    fi
-}
-
-# Function to cleanup test artifacts
-cleanup_test_artifacts() {
-    if [ "$CLEANUP" = true ]; then
-        print_status "INFO" "Cleaning up test artifacts..."
-        
-        # Remove test files
-        rm -f "$PROJECT_ROOT/.actrc"
-        rm -f "$PROJECT_ROOT/.env"
-        
-        # Clean up output directory
-        if [ -d "$OUTPUT_DIR" ]; then
-            rm -rf "$OUTPUT_DIR"
-        fi
-        
-        print_status "SUCCESS" "Cleanup complete"
-    fi
-}
-
-# Function to show test results
-show_test_results() {
-    if [ -d "$OUTPUT_DIR" ]; then
-        echo ""
-        print_status "INFO" "Test Results:"
-        echo "  Output directory: $OUTPUT_DIR"
-        
-        if [ "$VERBOSE" = true ]; then
-            echo "  Log files:"
-            find "$OUTPUT_DIR" -name "*.log" -exec basename {} \; | while read -r log_file; do
-                echo "    - $log_file"
-            done
-        fi
-    fi
-}
-
-# Parse command line arguments
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        -j|--skip-job-tests)
-            SKIP_JOB_TESTS=true
-            shift
-            ;;
-        -p|--skip-pipeline-tests)
-            SKIP_PIPELINE_TESTS=true
-            shift
-            ;;
-        -v|--verbose)
-            VERBOSE=true
-            shift
-            ;;
-        -d|--debug)
-            DEBUG=true
-            shift
-            ;;
-        -c|--no-cleanup)
-            CLEANUP=false
-            shift
-            ;;
-        -h|--help)
-            show_usage
-            exit 0
-            ;;
-        *)
-            echo -e "${RED}Unknown option: $1${NC}" >&2
-            show_usage
-            exit 1
-            ;;
-    esac
-done
-
-# Main execution
-main() {
-    echo -e "${BLUE}Comprehensive GitHub Actions Testing Suite${NC}"
-    echo -e "${CYAN}==========================================${NC}"
-    echo ""
-    
-    # Check prerequisites
-    check_prerequisites
-    
-    # Setup test environment
-    setup_test_environment
-    
-    # Run all tests
-    run_all_tests
-    
-    # Show results
-    show_test_results
-    
-    # Cleanup
-    cleanup_test_artifacts
-    
-    echo ""
-    print_status "SUCCESS" "Comprehensive testing complete!"
-}
-
-# Run main function
-main "$@"