gist-aliases.zsh

#!/bin/zsh
#################################################################
# 🚀 GITHUB GIST ALIASES & FUNCTIONS
# Collection of aliases for managing GitHub Gists via gh CLI
# Author: @trauco
# Date Added: 2024-01-15
# Dependencies: gh (GitHub CLI), vim
#################################################################

#################################################################
# 📝 SINGLE FILE GIST CREATION
#################################################################

# 🎯 gistedit - Create NEW file in vim, save locally, then push to public gist
# Usage: gistedit test.sh (creates test.sh locally and on gist)
# Date Added: 2024-01-15
alias gistedit='function _gistedit(){ 
  local filename="$1"
  if [ -z "$filename" ]; then
    echo "❌ Usage: gistedit <filename>"
    return 1
  fi
  vim "$filename"  # Create/edit NEW file in vim
  # File is saved locally when you :wq in vim
  gh gist create "$filename" --public  # Upload to public gist after vim closes
}; _gistedit'

# 📋 gisteditdesc - Edit file then create public gist with description
# Usage: gisteditdesc myfile.py
# Date Added: 2024-01-15
alias gisteditdesc='function _gisteditdesc(){
  local filename="$1"
  if [ -z "$filename" ]; then
    echo "❌ Usage: gisteditdesc <filename>"
    return 1
  fi
  vim "$filename"  # Edit file first
  local description
  echo "📝 Enter description for the Gist: "
  read description
  gh gist create "$filename" --public --description "$description"
}; _gisteditdesc'

# 🔒 gistsecret - Create NEW file in vim, save locally, then push to private gist
# Usage: gistsecret private_notes.txt (creates private_notes.txt locally and on gist)
# Date Added: 2024-01-15
alias gistsecret='function _gistsecret() { 
  local filename="$1"
  if [ -z "$filename" ]; then
    echo "❌ Usage: gistsecret <filename>"
    return 1
  fi
  vim "$filename"  # Create/edit NEW file in vim
  # File is saved locally when you :wq in vim
  gh gist create "$filename"  # Upload to private gist after vim closes (default is private)
}; _gistsecret'

#################################################################
# 📦 MULTI-FILE GIST CREATION
#################################################################

# 🌟 gistall - Create multiple NEW files in vim, save locally, then push all to public gist
# Usage: gistall file1.py file2.js README.md (creates all files locally and on gist)
# Date Added: 2024-01-15
function gistall() {
    if [ "$#" -eq 0 ]; then
        echo "❌ No files provided. Usage: gistall <file1> <file2> ... <fileN>"
        return 1
    fi
    echo "📦 Creating new files for public gist:"
    # Create/edit each file in vim
    for file in "$@"; do
        echo "  📝 Creating: $file"
        vim "$file"  # Create each file locally
    done
    echo "📝 Enter a description for the gist:"
    read -r description
    # Upload all files to public gist
    gh gist create "$@" --public -d "$description"
    echo "✅ Public gist created with all files!"
}

# 🔐 gistpriv - Create multiple NEW files in vim, save locally, then push all to private gist
# Usage: gistpriv secrets.env config.json (creates all files locally and on gist)
# Date Added: 2024-01-15
function gistpriv() {
    if [ "$#" -eq 0 ]; then
        echo "❌ No files provided. Usage: gistpriv <file1> <file2> ... <fileN>"
        return 1
    fi
    echo "🔒 Creating new files for private gist:"
    # Create/edit each file in vim
    for file in "$@"; do
        echo "  📝 Creating: $file"
        vim "$file"  # Create each file locally
    done
    echo "📝 Enter a description for the gist:"
    read -r description
    # Upload all files to private gist (gh defaults to private)
    gh gist create "$@" -d "$description"
    echo "✅ Private gist created with all files!"
}

#################################################################
# ⚙️ ENVIRONMENT CONFIGURATION
#################################################################

# 📝 Set vim as the default editor for gh CLI operations
# Date Added: 2024-01-15
export GH_EDITOR=vim

#################################################################
# 📚 QUICK REFERENCE
# - gistedit: Quick public gist (single file with vim edit)
# - gisteditdesc: Public gist with description (single file)
# - gistsecret: Quick private gist (single file with vim edit)
# - gistall: Public gist (multiple files)
# - gistpriv: Private gist (multiple files)
#################################################################