export_stars_simple.sh

#!/bin/bash
# Super simple GitHub stars export - just runs with defaults

# Configuration - EDIT THESE TWO LINES with your information
USERNAME="helloprkr"  # Your GitHub username
TOKEN=""     # Your GitHub token (optional but recommended)

# iCloud Path
ICLOUD_DIR="/Users/maximvs/Library/Mobile Documents/com~apple~CloudDocs/00X_000_JORDAN-PARKER-PLANS/Memory-🧿/00_GitHub/STARRED_github🌟"

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

# Create virtual environment
python3 -m venv "$VENV_DIR" 2>/dev/null || python -m venv "$VENV_DIR" 2>/dev/null

# Activate and install
source "${VENV_DIR}/bin/activate"
pip install -q PyGithub

# Create export script
TMP_FILE=$(mktemp)
cat > $TMP_FILE << 'PYTHONSCRIPT'
import os, sys, json, csv, datetime
from github import Github, GithubException

# Configuration (will be replaced)
GITHUB_USERNAME = "__USERNAME__"
GITHUB_TOKEN = "__TOKEN__"
OUTPUT_DIR = "__OUTDIR__"

# 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")

def get_github_stars(username, token=None):
    """Fetch starred repositories for a given GitHub username."""
    try:
        if token:
            g = Github(token)
        else:
            g = Github()
        
        print(f"Fetching starred repositories for {username}...")
        user = g.get_user(username)
        stars = user.get_starred()
        
        total_stars = stars.totalCount
        print(f"Found {total_stars} starred repositories")
        
        repos = []
        count = 0
        for repo in stars:
            count += 1
            repo_data = {
                "name": repo.name,
                "full_name": repo.full_name,
                "owner": repo.owner.login,
                "description": repo.description or "",
                "html_url": repo.html_url,
                "clone_url": repo.clone_url,
                "stars": repo.stargazers_count,
                "forks": repo.forks_count,
                "language": repo.language or "Not specified",
                "topics": repo.get_topics(),
                "created_at": repo.created_at.isoformat() if repo.created_at else None,
                "updated_at": repo.updated_at.isoformat() if repo.updated_at else None,
                "license": repo.license.name if repo.license else "No license",
                "is_archived": repo.archived,
                "is_fork": repo.fork
            }
            repos.append(repo_data)
            
            if count % 10 == 0:
                print(f"Processed {count}/{total_stars} repositories...")
        
        print(f"Completed fetching {count} repositories")
        return repos
    except GithubException as e:
        print(f"GitHub API error: {e}")
        return []
    except Exception as e:
        print(f"An error occurred: {e}")
        return []

def save_to_csv(repos, filename):
    """Save repositories to CSV file."""
    try:
        with open(filename, 'w', newline='', encoding='utf-8') as csvfile:
            fieldnames = ["name", "full_name", "owner", "description", "html_url", 
                          "clone_url", "stars", "forks", "language", "topics"]
            writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
            
            writer.writeheader()
            for repo in repos:
                repo_copy = repo.copy()
                repo_copy["topics"] = ", ".join(repo_copy["topics"])
                writer.writerow({field: repo_copy.get(field, "") for field in fieldnames})
        
        print(f"Saved CSV to {filename}")
    except Exception as e:
        print(f"Error saving to CSV: {e}")

def save_to_json(repos, filename):
    """Save repositories to JSON file."""
    try:
        with open(filename, 'w', encoding='utf-8') as jsonfile:
            json.dump(repos, jsonfile, indent=2)
        
        print(f"Saved JSON to {filename}")
    except Exception as e:
        print(f"Error saving to JSON: {e}")

def save_to_markdown(repos, filename):
    """Save repositories to Markdown file."""
    try:
        with open(filename, 'w', encoding='utf-8') as mdfile:
            mdfile.write(f"# Starred GitHub Repositories\n\n")
            mdfile.write(f"_Exported on {datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')}_\n\n")
            mdfile.write(f"Total repositories: **{len(repos)}**\n\n")
            
            # Group repositories by language
            languages = {}
            for repo in repos:
                lang = repo["language"] or "Not specified"
                if lang not in languages:
                    languages[lang] = []
                languages[lang].append(repo)
            
            # Sort languages by number of repositories
            sorted_languages = sorted(languages.items(), key=lambda x: len(x[1]), reverse=True)
            
            # Table of contents
            mdfile.write("## Table of Contents\n\n")
            for lang, lang_repos in sorted_languages:
                lang_anchor = lang.lower().replace(' ', '-').replace('#', 'sharp')
                mdfile.write(f"- [{lang} ({len(lang_repos)})](#user-content-{lang_anchor})\n")
            mdfile.write("\n")
            
            # Write repositories grouped by language
            for lang, lang_repos in sorted_languages:
                mdfile.write(f"## {lang}\n\n")
                
                # Sort repositories by stars
                sorted_repos = sorted(lang_repos, key=lambda x: x["stars"], reverse=True)
                
                for repo in sorted_repos:
                    mdfile.write(f"### [{repo['full_name']}]({repo['html_url']})\n\n")
                    if repo["description"]:
                        mdfile.write(f"{repo['description']}\n\n")
                    
                    mdfile.write(f"- **Stars:** {repo['stars']}\n")
                    mdfile.write(f"- **Language:** {repo['language']}\n")
                    
                    if repo["topics"]:
                        mdfile.write(f"- **Topics:** {', '.join(repo['topics'])}\n")
                    
                    mdfile.write("\n---\n\n")
        
        print(f"Saved Markdown to {filename}")
    except Exception as e:
        print(f"Error saving to Markdown: {e}")

def main():
    """Main function to run the script."""
    # Get username and token from substituted values
    username = GITHUB_USERNAME
    token = GITHUB_TOKEN
    
    if not username or username == "__USERNAME__":
        print("No GitHub username provided. Cannot proceed.")
        return
    
    if token == "__TOKEN__":
        token = ""
    
    if not token:
        print("No GitHub token provided. This may result in rate limiting.")
    
    # Get starred repositories
    repos = get_github_stars(username, token)
    
    if not repos:
        print("No repositories found or an error occurred.")
        return
    
    # Save to different formats
    save_to_csv(repos, CSV_FILE)
    save_to_json(repos, JSON_FILE)
    save_to_markdown(repos, MARKDOWN_FILE)
    
    print(f"Export complete! Files saved to: {OUTPUT_DIR}")

if __name__ == "__main__":
    # Verify username is set correctly
    print(f"Username: {GITHUB_USERNAME}")
    if GITHUB_USERNAME and GITHUB_USERNAME != "__USERNAME__":
        main()
    else:
        print("ERROR: GitHub username not set properly!")
PYTHONSCRIPT

# Replace variables in the script
sed -i "" "s|__USERNAME__|$USERNAME|g" $TMP_FILE
sed -i "" "s|__TOKEN__|$TOKEN|g" $TMP_FILE
sed -i "" "s|__OUTDIR__|$SCRIPT_DIR|g" $TMP_FILE

# Run the script
echo "Running GitHub Stars export..."
python $TMP_FILE

# Clean up
rm $TMP_FILE

# Copy to iCloud
if [ -d "$ICLOUD_DIR" ]; then
    echo "Copying files to iCloud..."
    mkdir -p "$ICLOUD_DIR"
    cp github_stars.* "$ICLOUD_DIR/"
    echo "Files copied to: $ICLOUD_DIR"
fi

deactivate
echo "Done! Your GitHub stars have been exported."