Public/Invoke-Git.ps1
|
Function Invoke-Git { <# .SYNOPSIS Wrapper to invoke git.exe and return streams .FUNCTIONALITY CI/CD .DESCRIPTION Wrapper to invoke git.exe and return streams .PARAMETER Arguments If specified, call git with these arguments. This takes a positional argument and accepts all value afterwards for a more natural 'git-esque' use. .PARAMETER Path Working directory to launch git.exe within. Defaults to current location .PARAMETER RedirectStandardError Whether to capture standard error. Defaults to $true .PARAMETER RedirectStandardOutput Whether to capture standard output. Defaults to $true .PARAMETER UseShellExecute See System.Diagnostics.ProcessStartInfo. Defaults to $false .PARAMETER Raw If specified, return an object with the command, output, and error properties. Without Raw or Quiet, we return output if there's output, and we write an error if there are errors .PARAMETER Split If specified, split output and error on this. Defaults to `n .PARAMETER Quiet If specified, do not return output .PARAMETER GitPath Path to git.exe. Defaults to git.exe (i.e. git.exe is in $ENV:PATH) .EXAMPLE Invoke-Git rev-parse HEAD # Get the current commit hash for HEAD .EXAMPLE Invoke-Git rev-parse HEAD -path C:\sc\PSStackExchange # Get the current commit hash for HEAD for the repo located at C:\sc\PSStackExchange .LINK https://github.com/RamblingCookieMonster/BuildHelpers .LINK about_BuildHelpers #> [cmdletbinding()] param( [parameter(Position = 0, ValueFromRemainingArguments = $true)] $Arguments, $NoWindow = $true, $RedirectStandardError = $true, $RedirectStandardOutput = $true, $UseShellExecute = $false, $Path = $PWD.Path, $Quiet, $Split = "`n", $Raw, [validatescript({ if(-not (Get-Command $_)) { throw "Could not find command at GitPath [$_]" } $true })] [string]$GitPath = 'git.exe' ) $Path = (Resolve-Path $Path).Path # http://stackoverflow.com/questions/8761888/powershell-capturing-standard-out-and-error-with-start-process $pinfo = New-Object System.Diagnostics.ProcessStartInfo $pinfo.FileName = $GitPath $Command = $GitPath $pinfo.CreateNoWindow = $NoWindow $pinfo.RedirectStandardError = $RedirectStandardError $pinfo.RedirectStandardOutput = $RedirectStandardOutput $pinfo.UseShellExecute = $UseShellExecute $pinfo.WorkingDirectory = $Path if($PSBoundParameters.ContainsKey('Arguments')) { $pinfo.Arguments = $Arguments $Command = "$Command $Arguments" } $p = New-Object System.Diagnostics.Process $p.StartInfo = $pinfo $null = $p.Start() $p.WaitForExit() if($Quiet) { return } else { #there was a newline in output... if($stdout = $p.StandardOutput.ReadToEnd()) { if($split) { $stdout = $stdout -split "`n" | Where {$_} } $stdout = foreach($item in @($stdout)){ $item.trim() } } if($stderr = $p.StandardError.ReadToEnd()) { if($split) { $stderr = $stderr -split "`n" | Where {$_} } $stderr = foreach($item in @($stderr)){ $item.trim() } } if($Raw) { [pscustomobject]@{ Command = $Command Output = $stdout Error = $stderr } } else { if($stdout) { $stdout } if($stderr) { Write-Error $stderr.trim() } } } } |