export_github_stars.sh

#!/bin/bash

# GitHub Stars Export Script - Foolproof Edition
# This script helps export GitHub starred repositories without requiring any technical knowledge

# Configuration - edit these variables (leaving blank is fine - you'll be prompted)
GITHUB_USERNAME=""  # Your GitHub username
GITHUB_TOKEN=""     # Your GitHub personal access token (optional)
ICLOUD_DIR="/Users/maximvs/Library/Mobile Documents/com~apple~CloudDocs/00X_000_JORDAN-PARKER-PLANS/Memory-🧿/00_GitHub/STARRED_github🌟"

# Workspace
SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
VENV_DIR="${SCRIPT_DIR}/venv"

# Color definitions
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[0;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color

echo -e "${BLUE}================================================${NC}"
echo -e "${BLUE}GitHub Starred Repositories Exporter${NC}"
echo -e "${BLUE}================================================${NC}"
echo -e "${GREEN}This script will export all your starred repositories from GitHub${NC}"
echo -e "${GREEN}Just answer a few simple questions and it will do everything for you.${NC}"
echo

# Check if Python 3 is installed
if ! command -v python3 &> /dev/null; then
    echo -e "${RED}Python 3 is required but not installed.${NC}"
    echo -e "${YELLOW}Please install Python 3 from python.org and try again.${NC}"
    exit 1
fi

# Set up virtual environment to avoid system package issues
echo -e "${BLUE}Setting up Python environment...${NC}"
if [ ! -d "$VENV_DIR" ]; then
    echo -e "${GREEN}Creating virtual environment...${NC}"
    python3 -m venv "$VENV_DIR" || {
        echo -e "${RED}Failed to create virtual environment. Trying an alternative method...${NC}"
        # Try with the -m venv module directly
        python3 -m venv "$VENV_DIR" || {
            echo -e "${RED}Failed to create virtual environment. Please install virtualenv:${NC}"
            echo -e "${YELLOW}pip3 install --user virtualenv${NC}"
            exit 1
        }
    }
fi

# Activate virtual environment
echo -e "${GREEN}Activating virtual environment...${NC}"
source "${VENV_DIR}/bin/activate" || {
    echo -e "${RED}Failed to activate virtual environment.${NC}"
    exit 1
}

# Install required packages in the virtual environment
echo -e "${GREEN}Installing required packages...${NC}"
pip install PyGithub || {
    echo -e "${RED}Failed to install PyGithub package.${NC}"
    echo -e "${YELLOW}Please check your internet connection and try again.${NC}"
    deactivate
    exit 1
}

# Get GitHub username if not already set
if [ -z "$GITHUB_USERNAME" ]; then
    echo -e "${YELLOW}Enter your GitHub username:${NC}"
    read GITHUB_USERNAME
    
    # Validate input isn't empty
    while [ -z "$GITHUB_USERNAME" ]; do
        echo -e "${RED}Username cannot be empty. Please enter your GitHub username:${NC}"
        read GITHUB_USERNAME
    done
fi

# Ask about GitHub token if not set
if [ -z "$GITHUB_TOKEN" ]; then
    echo -e "${YELLOW}Do you want to use a GitHub personal access token? (recommended) [Y/n]:${NC}"
    echo -e "${GREEN}This allows accessing private stars and avoids rate limits${NC}"
    read USE_TOKEN
    
    # Default to yes if enter is pressed
    if [[ -z "$USE_TOKEN" || $USE_TOKEN =~ ^[Yy]$ ]]; then
        echo -e "${YELLOW}Enter your GitHub personal access token:${NC}"
        echo -e "${GREEN}(Create one at https://github.com/settings/tokens with 'repo' and 'read:user' scopes)${NC}"
        read -s GITHUB_TOKEN
        echo
        
        # Check if token is empty but allow continuing
        if [ -z "$GITHUB_TOKEN" ]; then
            echo -e "${YELLOW}No token entered. Proceeding without authentication.${NC}"
            echo -e "${YELLOW}This may result in rate limiting for large numbers of repositories.${NC}"
        fi
    else
        echo -e "${YELLOW}Proceeding without authentication. This may result in rate limiting.${NC}"
    fi
fi

# Prepare the Python export script
echo -e "${GREEN}Preparing export script...${NC}"

# Create a custom script with the provided credentials
CUSTOM_SCRIPT="${SCRIPT_DIR}/custom_export.py"
cat > "$CUSTOM_SCRIPT" << EOF
#!/usr/bin/env python3
import os
import sys
import json
import csv
import datetime
from github import Github, GithubException

# Configuration
GITHUB_USERNAME = "${GITHUB_USERNAME}"
GITHUB_TOKEN = "${GITHUB_TOKEN}"
OUTPUT_DIR = "${SCRIPT_DIR}"

# File paths
CSV_FILE = os.path.join(OUTPUT_DIR, "github_stars.csv")
JSON_FILE = os.path.join(OUTPUT_DIR, "github_stars.json")
MARKDOWN_FILE = os.path.join(OUTPUT_DIR, "github_stars.md")
README_FILE = os.path.join(OUTPUT_DIR, "github_stars_README.md")

# Re-use all the functions from the original script
$(cat "${SCRIPT_DIR}/export_github_stars.py" | grep -A 10000 "def get_github_stars" | grep -v "GITHUB_USERNAME")

if __name__ == "__main__":
    main()
EOF

# Make the script executable
chmod +x "$CUSTOM_SCRIPT"

# Run the custom script
echo -e "${BLUE}Starting export process...${NC}"
echo -e "${YELLOW}This might take a while depending on how many repositories you've starred.${NC}"
echo -e "${YELLOW}Please be patient...${NC}"
echo

python "$CUSTOM_SCRIPT"

# Check if export was successful
if [ ! -f "${SCRIPT_DIR}/github_stars.csv" ]; then
    echo -e "${RED}Export seems to have failed. No output files were created.${NC}"
    echo -e "${YELLOW}Please check any error messages above and try again.${NC}"
    # Clean up
    rm -f "$CUSTOM_SCRIPT"
    deactivate
    exit 1
fi

# Clean up the custom script
rm -f "$CUSTOM_SCRIPT"

# Ask if user wants to move files to iCloud
echo
echo -e "${YELLOW}Do you want to move the exported files to iCloud? [Y/n]:${NC}"
read MOVE_TO_ICLOUD

# Default to yes if enter is pressed
if [[ -z "$MOVE_TO_ICLOUD" || $MOVE_TO_ICLOUD =~ ^[Yy]$ ]]; then
    # Check if the directory exists
    if [ ! -d "$ICLOUD_DIR" ]; then
        echo -e "${YELLOW}The iCloud directory does not exist. Creating it...${NC}"
        mkdir -p "$ICLOUD_DIR" || {
            echo -e "${RED}Failed to create iCloud directory.${NC}"
            echo -e "${YELLOW}The files will remain in the current directory.${NC}"
            deactivate
            exit 1
        }
    fi
    
    # Move the files
    echo -e "${GREEN}Moving files to iCloud...${NC}"
    cp "${SCRIPT_DIR}/github_stars.csv" "${SCRIPT_DIR}/github_stars.json" "${SCRIPT_DIR}/github_stars.md" "${SCRIPT_DIR}/github_stars_README.md" "$ICLOUD_DIR/" || {
        echo -e "${RED}Error: Failed to copy files to iCloud.${NC}"
        echo -e "${YELLOW}The files remain in the current directory.${NC}"
        deactivate
        exit 1
    }
    
    echo -e "${GREEN}Files successfully copied to:${NC}"
    echo -e "${BLUE}$ICLOUD_DIR${NC}"
    
    # List the files in the iCloud directory
    echo -e "${GREEN}Files in iCloud directory:${NC}"
    ls -la "$ICLOUD_DIR" | grep github_stars
else
    echo -e "${GREEN}Files remain in the current directory:${NC}"
    ls -la "${SCRIPT_DIR}" | grep github_stars
fi

# Deactivate virtual environment
deactivate

echo
echo -e "${GREEN}GitHub Stars export completed successfully!${NC}"
echo -e "${BLUE}================================================${NC}"
echo -e "${YELLOW}You can view your starred repositories in the exported files.${NC}"
echo -e "${YELLOW}The markdown file (github_stars.md) is the most human-readable format.${NC}"
echo