setup_github_mac.sh

#!/bin/bash

################################################################################
# GitHub Setup Script for macOS
# This script configures Git and GitHub on a Mac using username and password
# Note: GitHub deprecated password authentication. Use Personal Access Token (PAT)
# instead of password for better security.
################################################################################

set -e

# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m' # No Color

# Function to print colored output
print_status() {
    echo -e "${GREEN}[✓]${NC} $1"
}

print_error() {
    echo -e "${RED}[✗]${NC} $1"
}

print_warning() {
    echo -e "${YELLOW}[!]${NC} $1"
}

################################################################################
# Step 1: Check if Homebrew is installed
################################################################################
check_homebrew() {
    print_status "Checking for Homebrew..."
    
    if ! command -v brew &> /dev/null; then
        print_warning "Homebrew not found. Installing Homebrew..."
        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
        print_status "Homebrew installed successfully"
    else
        print_status "Homebrew is already installed"
    fi
}

################################################################################
# Step 2: Install Git if not present
################################################################################
install_git() {
    print_status "Checking for Git..."
    
    if ! command -v git &> /dev/null; then
        print_warning "Git not found. Installing Git..."
        brew install git
        print_status "Git installed successfully"
    else
        print_status "Git is already installed: $(git --version)"
    fi
}

################################################################################
# Step 3: Configure Git with user credentials
################################################################################
configure_git_credentials() {
    echo ""
    print_status "Configuring Git credentials..."
    
    read -p "Enter your GitHub username: " github_username
    read -sp "Enter your GitHub password or Personal Access Token: " github_password
    echo ""
    
    # Validate input
    if [[ -z "$github_username" ]]; then
        print_error "Username cannot be empty"
        exit 1
    fi
    
    if [[ -z "$github_password" ]]; then
        print_error "Password/Token cannot be empty"
        exit 1
    fi
    
    # Configure git credentials
    git config --global user.name "$github_username"
    git config --global user.email "$github_username@github.com"
    
    print_status "Git configured with username: $github_username"
}

################################################################################
# Step 4: Setup Git credentials helper (macOS Keychain)
################################################################################
setup_credentials_helper() {
    print_status "Setting up Git credentials helper (macOS Keychain)..."
    
    # Store credentials in macOS Keychain
    git config --global credential.helper osxkeychain
    
    print_status "Credentials helper configured for macOS Keychain"
}

################################################################################
# Step 5: Store credentials in Keychain
################################################################################
store_credentials_in_keychain() {
    echo ""
    print_status "Storing credentials in macOS Keychain..."
    
    read -p "Enter your GitHub username: " github_username
    read -sp "Enter your GitHub password or Personal Access Token: " github_password
    echo ""
    
    # Use git credential helper to store credentials
    echo "https://$github_username:$github_password@github.com" | \
    git credential-osxkeychain store
    
    print_status "Credentials stored in macOS Keychain"
}

################################################################################
# Step 6: Test GitHub connection
################################################################################
test_github_connection() {
    echo ""
    print_status "Testing GitHub connection..."
    
    if ssh -T git@github.com &> /dev/null; then
        print_status "SSH connection to GitHub successful"
    else
        print_warning "SSH not configured. Testing HTTPS connection instead..."
        git config --global url."https://github.com/".insteadOf git://github.com/
        print_status "Configured to use HTTPS protocol"
    fi
}

################################################################################
# Step 7: Clone test repository
################################################################################
clone_test_repo() {
    echo ""
    read -p "Do you want to clone the test repository (vigu01/courses)? (y/n): " -n 1 -r
    echo ""
    
    if [[ $REPLY =~ ^[Yy]$ ]]; then
        test_repo_dir="$HOME/github_test_repo"
        
        if [ -d "$test_repo_dir" ]; then
            print_warning "Test directory already exists at $test_repo_dir"
            read -p "Overwrite? (y/n): " -n 1 -r
            echo ""
            if [[ $REPLY =~ ^[Yy]$ ]]; then
                rm -rf "$test_repo_dir"
            else
                return
            fi
        fi
        
        print_status "Cloning test repository..."
        git clone https://github.com/vigu01/courses.git "$test_repo_dir"
        print_status "Test repository cloned to: $test_repo_dir"
        
        cd "$test_repo_dir"
        print_status "Repository details:"
        echo "  Remote URL: $(git config --get remote.origin.url)"
        echo "  Branch: $(git branch --show-current)"
    fi
}

################################################################################
# Step 8: Display Git configuration
################################################################################
display_config() {
    echo ""
    print_status "Current Git configuration:"
    echo "  User Name: $(git config --global user.name)"
    echo "  User Email: $(git config --global user.email)"
    echo "  Credential Helper: $(git config --global credential.helper)"
    echo ""
}

################################################################################
# Step 9: Display security warning
################################################################################
display_security_warning() {
    echo ""
    echo -e "${YELLOW}╔════════════════════════════════════════════════════════════╗${NC}"
    echo -e "${YELLOW}║          SECURITY WARNING & BEST PRACTICES                 ║${NC}"
    echo -e "${YELLOW}╚════════════════════════════════════════════════════════════╝${NC}"
    echo ""
    echo "⚠️  GitHub deprecated password authentication!"
    echo ""
    echo "Recommended: Use Personal Access Token (PAT) instead:"
    echo "  1. Go to: https://github.com/settings/tokens"
    echo "  2. Click 'Generate new token (classic)'"
    echo "  3. Select scopes: repo, read:user, user:email"
    echo "  4. Copy the token and use it as your password in this script"
    echo ""
    echo "For SSH setup (more secure):"
    echo "  ssh-keygen -t ed25519 -C 'your_email@example.com'"
    echo "  cat ~/.ssh/id_ed25519.pub | pbcopy"
    echo "  Paste at: https://github.com/settings/keys"
    echo ""
    echo "Never commit credentials or tokens to repositories!"
    echo ""
}

################################################################################
# Main execution
################################################################################
main() {
    echo ""
    echo "╔════════════════════════════════════════════════════════════╗"
    echo "║        GitHub Setup Script for macOS                       ║"
    echo "╚════════════════════════════════════════════════════════════╝"
    echo ""
    
    display_security_warning
    
    check_homebrew
    install_git
    configure_git_credentials
    setup_credentials_helper
    store_credentials_in_keychain
    test_github_connection
    clone_test_repo
    display_config
    
    echo ""
    print_status "GitHub setup completed successfully!"
    echo ""
}

# Run main function
main "$@"