pwsh-gitignore-template.ps1

# ======================================================================
# Cross-platform: auto-copy .gitignore after `git init`
# - PowerShell 7+ on Windows / macOS / Linux
# - Put AFTER posh-git or other module imports in your $PROFILE
#
# Git Init Wrapper v1.0.0 - Cross-platform auto .gitignore
#
# Commands:
#   $Global:GIT_INIT_WRAPPER_DEBUG = $true|$false   # toggle debug output
#   New-GitIgnoreTemplate [-UseGitConfig] [-SetEnvironment] [-Path <file>] [-Content <text>]
#   Get-GitIgnoreTemplatePaths [-Refresh]           # returns FoundPath/Candidates
#   Show-GitIgnoreTemplatePaths                     # pretty diagnostics (defined below)
#   Copy-GitIgnoreFromTemplate -WorkTree <dir> [-Force]  # manual copy
#   git init [options] [dir]                        # normal usage; .gitignore is created silently
# ======================================================================

# --- DEBUG switch (set to $true to see messages; $false = silent) ---
$Global:GIT_INIT_WRAPPER_DEBUG = $false
function __DBG { param([string]$Msg,[string]$Color='Gray'); if ($Global:GIT_INIT_WRAPPER_DEBUG) { Write-Host $Msg -ForegroundColor $Color } }

# Resolve real git binary cross-platform (avoid recursion if a 'git' function exists)
$Global:__RealGitExe = (Get-Command git -CommandType Application -ErrorAction SilentlyContinue).Source
if (-not $Global:__RealGitExe -and $IsWindows) {
    $Global:__RealGitExe = (Get-Command git.exe -CommandType Application -ErrorAction SilentlyContinue).Source
}
if (-not $Global:__RealGitExe) { $Global:__RealGitExe = 'git' }  # best-effort fallback

# ---------- 5s cached template discovery ----------
$script:__TplCache = $null
function Get-GitIgnoreTemplatePaths {
    param([switch]$Refresh)

    if ($Refresh -or -not $script:__TplCache -or (Get-Date) -gt $script:__TplCache.Expires) {
        $candidates = New-Object System.Collections.Generic.List[string]

        # 1) Explicit environment variable (process/user/system)
        if ($env:GIT_IGNORE_TEMPLATE) { $candidates.Add($env:GIT_IGNORE_TEMPLATE) }

        # 2) git config init.templateDir (global then system)
        try {
            $g = & $Global:__RealGitExe config --global --get init.templateDir 2>$null
            if ($g) { $candidates.Add( (Join-Path $g '.gitignore') ) }
        } catch {}
        try {
            $s = & $Global:__RealGitExe config --system --get init.templateDir 2>$null
            if ($s) { $candidates.Add( (Join-Path $s '.gitignore') ) }
        } catch {}

        # 3) Common locations (OS-aware)
        $candidates.Add("$HOME/.git-templates/.gitignore")
        $candidates.Add("$HOME/.gitignore-template")
        if ($IsWindows) {
            if ($env:APPDATA)     { $candidates.Add("$env:APPDATA/git/templates/.gitignore") }
            if ($env:ProgramData) { $candidates.Add("$env:ProgramData/Git/templates/.gitignore") }
        } else {
            $candidates.Add("$HOME/.config/git/templates/.gitignore")
            $candidates.Add("/usr/share/git-core/templates/.gitignore")
            $candidates.Add("/usr/local/share/git-core/templates/.gitignore")
        }

        $found = $null
        foreach ($p in $candidates) {
            if ($p -and (Test-Path -LiteralPath $p)) { $found = $p; break }
        }

        $script:__TplCache = [pscustomobject]@{
            FoundPath = $found
            Candidates = $candidates
            Expires = (Get-Date).AddSeconds(5)
        }
    }
    return $script:__TplCache
}

function Show-GitIgnoreTemplatePaths {
    $info = Get-GitIgnoreTemplatePaths -Refresh

    Write-Host ""
    Write-Host "Template Search Results:" -ForegroundColor Cyan

    $found = if ($info.FoundPath) { $info.FoundPath } else { 'None' }
    Write-Host "Found: $found" -ForegroundColor $(if ($info.FoundPath) { 'Green' } else { 'Yellow' })

    Write-Host ""
    Write-Host "Searched (in order):" -ForegroundColor Gray
    foreach ($p in $info.Candidates) {
        $exists = Test-Path -LiteralPath $p
        $tick = if ($exists) { '✓' } else { ' ' }
        Write-Host ("  {0} {1}" -f $tick, $p) -ForegroundColor $(if ($exists) { 'Green' } else { 'DarkGray' })
    }
}

function Copy-GitIgnoreFromTemplate {
    param(
        [Parameter(Mandatory=$true)] [string]$WorkTree,
        [switch]$Force
    )
    $info = Get-GitIgnoreTemplatePaths
    $template = $info.FoundPath
    if (-not $template) {
        __DBG "ℹ No .gitignore template found. Set `$env:GIT_IGNORE_TEMPLATE or create $HOME/.git-templates/.gitignore" 'Yellow'
        return
    }
    $dest = Join-Path $WorkTree '.gitignore'
    if ((Test-Path -LiteralPath $dest) -and -not $Force) {
        __DBG "⚠ .gitignore already exists in $WorkTree (use -Force to overwrite)" 'Yellow'
        return
    }
    try {
        Copy-Item -LiteralPath $template -Destination $dest -Force
        __DBG "✓ Created .gitignore in $WorkTree from $template" 'Green'
    } catch {
        __DBG "✗ Failed to copy .gitignore: $_" 'Red'
    }
}

# ---------- Wrapper: intercept ANY `init`; pass all else through ----------
function git {
    param([Parameter(ValueFromRemainingArguments=$true)] [string[]]$Args)

    # No args -> call real git; keep exit code, print nothing
    if (-not $Args -or $Args.Count -eq 0) {
        & $Global:__RealGitExe
        $global:LASTEXITCODE = $LASTEXITCODE
        if ($Global:GIT_INIT_WRAPPER_DEBUG -and $LASTEXITCODE -ne 0) { __DBG "git exited with code $LASTEXITCODE" 'Yellow' }
        return
    }

    # Find 'init' anywhere (handles: git -C dir --no-pager init -q -b main target)
    $lower = $Args | ForEach-Object { $_.ToLowerInvariant() }
    $initIndex = $lower.IndexOf('init')

    if ($initIndex -ge 0) {
        # Run real git first (so the repo actually exists)
        & $Global:__RealGitExe @Args
        $exitCode = $LASTEXITCODE
        $global:LASTEXITCODE = $exitCode
        if ($exitCode -ne 0) { if ($Global:GIT_INIT_WRAPPER_DEBUG) { __DBG "git exited with code $exitCode" 'Yellow' } ; return }

        # Skip bare repos
        if ($Args -contains '--bare') { return }

        # Determine effective base dir from the last '-C <dir>'
        $baseDir = (Get-Location).Path
        for ($i = 0; $i -lt $Args.Count - 1; $i++) {
            if ($Args[$i] -eq '-C') {
                try { $baseDir = (Resolve-Path -LiteralPath $Args[$i+1]).Path } catch {}
            }
        }

        # Last non-flag token AFTER 'init' is the candidate target dir (if any)
        $dirArg = $null
        for ($i = $initIndex + 1; $i -lt $Args.Count; $i++) {
            $tok = $Args[$i]
            if ($tok -eq '--') { continue }
            if ($tok -like '-*') { continue }
            $dirArg = $tok
        }

        # Determine repo root
        $repoRoot = $null
        try {
            if ($dirArg) {
                $candidate = (Resolve-Path -LiteralPath (Join-Path $baseDir $dirArg) -ErrorAction SilentlyContinue).Path
                if ($candidate) { $repoRoot = $candidate }
            }
            if (-not $repoRoot) {
                $repoRoot = (& $Global:__RealGitExe -C $baseDir rev-parse --show-toplevel 2>$null)
            }
        } catch {}
        if (-not $repoRoot) { $repoRoot = $baseDir }

        # Double-check: not a bare repo
        try {
            $isBare = (& $Global:__RealGitExe -C $repoRoot rev-parse --is-bare-repository 2>$null) -eq 'true'
        } catch { $isBare = $false }

        if (-not $isBare) {
            Copy-GitIgnoreFromTemplate -WorkTree $repoRoot
        }
        return
    }

    # Not an 'init' call -> pass through, keep exit code, print nothing
    & $Global:__RealGitExe @Args
    $global:LASTEXITCODE = $LASTEXITCODE
    if ($Global:GIT_INIT_WRAPPER_DEBUG -and $LASTEXITCODE -ne 0) { __DBG "git exited with code $LASTEXITCODE" 'Yellow' }
    return
}

# ---------- Helper to create/set a template quickly ----------
function New-GitIgnoreTemplate {
    [CmdletBinding()]
    param(
        [string]$Path,
        [switch]$UseGitConfig,   # Create under git's init.templateDir (and set it if missing)
        [switch]$SetEnvironment, # Persist $env:GIT_IGNORE_TEMPLATE (profile on Unix; User env on Windows)
        [string]$Content
    )

    if ($UseGitConfig) {
        $tplDir = & $Global:__RealGitExe config --global --get init.templateDir 2>$null
        if (-not $tplDir) {
            $tplDir = "$HOME/.git-templates"
            & $Global:__RealGitExe config --global init.templateDir $tplDir | Out-Null
            __DBG "✓ Set git global init.templateDir to $tplDir" 'Green'
        }
        if (-not (Test-Path -LiteralPath $tplDir)) { New-Item -ItemType Directory -Path $tplDir -Force | Out-Null }
        if (-not $Path) { $Path = (Join-Path $tplDir '.gitignore') }
    } else {
        if (-not $Path) { $Path = "$HOME/.git-templates/.gitignore" }
        $dir = Split-Path $Path -Parent
        if (-not (Test-Path -LiteralPath $dir)) { New-Item -ItemType Directory -Path $dir -Force | Out-Null }
    }

    if (-not $Content) {
@"
# Created by https://www.toptal.com/developers/gitignore/api/git,linux,macos,windows
# Edit at https://www.toptal.com/developers/gitignore?templates=git,linux,macos,windows

### Git ###
# Created by git for backups. To disable backups in Git:
# $ git config --global mergetool.keepBackup false
*.orig

# Created by git when using merge tools for conflicts
*.BACKUP.*
*.BASE.*
*.LOCAL.*
*.REMOTE.*
*_BACKUP_*.txt
*_BASE_*.txt
*_LOCAL_*.txt
*_REMOTE_*.txt

### Linux ###
*~

# temporary files which can be created if a process still has a handle open of a deleted file
.fuse_hidden*

# KDE directory preferences
.directory

# Linux trash folder which might appear on any partition or disk
.Trash-*

# .nfs files are created when an open file is removed but is still being accessed
.nfs*

### macOS ###
# General
.DS_Store
.AppleDouble
.LSOverride

# Icon must end with two \r
Icon


# Thumbnails
._*

# Files that might appear in the root of a volume
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent

# Directories potentially created on remote AFP share
.AppleDB
.AppleDesktop
Network Trash Folder
Temporary Items
.apdisk

### macOS Patch ###
# iCloud generated files
*.icloud

### Windows ###
# Windows thumbnail cache files
Thumbs.db
Thumbs.db:encryptable
ehthumbs.db
ehthumbs_vista.db

# Dump file
*.stackdump

# Folder config file
[Dd]esktop.ini

# Recycle Bin used on file shares
$RECYCLE.BIN/

# Windows Installer files
*.cab
*.msi
*.msix
*.msm
*.msp

# Windows shortcuts
*.lnk

# End of https://www.toptal.com/developers/gitignore/api/git,linux,macos,windows
"@ | Set-Content -Path $Path -Encoding UTF8
    } else {
        $Content | Set-Content -Path $Path -Encoding UTF8
    }

    __DBG "✓ Template written: $Path" 'Green'

    if ($SetEnvironment) {
        if ($IsWindows) {
            [Environment]::SetEnvironmentVariable('GIT_IGNORE_TEMPLATE', $Path, 'User')
            __DBG "✓ Set User env var GIT_IGNORE_TEMPLATE=$Path" 'Green'
        } else {
            try {
                Add-Content -Path $PROFILE -Value "`n`$env:GIT_IGNORE_TEMPLATE = '$Path'"
                __DBG "✓ Appended to `$PROFILE to persist GIT_IGNORE_TEMPLATE" 'Green'
            } catch {
                __DBG "⚠ Could not write to `$PROFILE; set manually: `$env:GIT_IGNORE_TEMPLATE = '$Path'" 'Yellow'
            }
        }
        $env:GIT_IGNORE_TEMPLATE = $Path  # current session
        Get-GitIgnoreTemplatePaths -Refresh | Out-Null
    }
}

# ---------- Session status (only when DEBUG=true) ----------
if ($Global:GIT_INIT_WRAPPER_DEBUG) {
    $__status = Get-GitIgnoreTemplatePaths
    if ($__status.FoundPath) {
        __DBG "✓ Git 'init' wrapper active; template: $($__status.FoundPath)" 'Green'
    } else {
        __DBG "ℹ Git 'init' wrapper active; no template found. Run: New-GitIgnoreTemplate" 'Yellow'
    }
}
# ======================================================================