Merge pull request #208 from StartAutomating/ugit-the-blame

ugit 0.4.2

Author: StartAutomating

CHANGELOG.md

@@ -1,3 +1,11 @@
+## 0.4.2:
+
+* git blame support (#192, #193, #199, #201)
+* Use-Git will write to Verbose, not warning, when a directory is not a repository (#198, #204)
+* ugit PSA improvements (#189, #205, #206, #207)
+
+---
+
 ## 0.4.1:
 
 * New Git Command Support:

Extensions/Git.Blame.Input.ugit.extension.ps1

@@ -0,0 +1,50 @@
+<#
+.SYNOPSIS
+    Extends git blame's parameters
+.DESCRIPTION
+    Extends the parameters for git blame.
+#>
+[ValidatePattern('^git blame')]
+[Management.Automation.Cmdlet("Use","Git")]
+[CmdletBinding(PositionalBinding=$false)]
+param(
+# The line number (and relative offset)
+[Parameter(ValueFromPipelineByPropertyName)]
+[int[]]
+$LineNumber,
+
+# The blame pattern to look for.
+[Parameter(ValueFromPipelineByPropertyName)]
+[string[]]
+$Pattern
+)
+
+process {
+    
+    # All git of these git blame parameters need to be after the input object:
+    foreach ($gitArgToBe in @(
+            if ($LineNumber) { # If a -LineNumber was provided
+                # turn each pair into a range
+                for ($LineNumberNumber = 0; $LineNumberNumber -lt $LineNumber.Length; $LineNumberNumber++) {                    
+                    "-L" # (this will be specified by git blame's real parameter, '-L')
+                    "$(
+                        if ($LineNumberNumber -lt ($LineNumber.Length - 1)) {                            
+                            "$($lineNumber[$LineNumberNumber]),$($lineNumber[$LineNumberNumber + 1])"       
+                        } else {
+                            # if there was only one of a pair, only grab that line.
+                            "$($lineNumber[$LineNumberNumber]),1"
+                        }
+                    )"
+                }
+            }
+
+            if ($Pattern) { # If a -Pattern was provided
+                foreach ($linePattern in $pattern) {
+                    "-L" # this also becomes '-L' in git blame
+                    "$linePattern"
+                }
+            }
+    )) {    
+        $gitArgToBe | Add-Member NoteProperty AfterInput $true -Force -PassThru
+    }
+}

Extensions/Git.Blame.UGit.extension.ps1

@@ -0,0 +1,61 @@
+<#
+.SYNOPSIS
+    Parses git blame output
+.DESCRIPTION
+    Parses the output of git blame.
+.EXAMPLE    
+    git blame ugit.psd1    
+#>
+[Management.Automation.Cmdlet("Out","Git")]            # It's an extension for Out-Git
+[ValidatePattern("^u?git blame",Options='IgnoreCase')] # when the pattern is "git blame"
+param()
+
+begin {
+    $gitBlameOutput = @()
+    $blameHeaderPattern = @(
+        '(?<CommitHash>[0-9a-f]{8})\s'
+        
+        # If your filename contains parenthesis, this may not work, and you'll only have yourself to blame.
+        '(?:(?<FileName>[\S-[\(]]+)\s)?' 
+        
+        '\((?<WhoWhenWhat>.+?)\)'
+    ) -join ''
+    $blameRevision = @($gitCommand -split '\s' -notmatch '^--')[-1]
+}
+
+process {
+    $gitBlameOutput += $gitout    
+}
+
+end {
+    $blameObjects = @(
+        foreach ($gitBlameLine in $gitBlameOutput) {
+            if ($gitBlameLine -notmatch $blameHeaderPattern) { continue }
+            $lineContent  = $gitBlameLine -replace $blameHeaderPattern            
+            $commitMatch = [Ordered]@{} + $matches
+            $whoWhenWhat = $commitMatch.WhoWhenWhat -split '\s+'
+            
+            [PSCustomObject][Ordered]@{
+                PSTypeName = 'git.blame'
+                CommitHash = $commitMatch.CommitHash
+                CommitDate = ($whoWhenWhat[-4..-2] -join ' ') -as [DateTime]
+                Line       = $whoWhenWhat[-1]
+                File       = $matches.File
+                Revision   = $blameRevision
+                Content    = $lineContent
+                GitRoot    = $GitRoot
+                Author     = $whoWhenWhat[0..$(
+                    ($whoWhenWhat.Length - 5)
+                )] -join ' '
+                GitOutputLines = $gitBlameLine
+            }
+        }
+    )
+
+    if ($blameObjects) {
+        $blameObjects
+    } else {
+        $gitBlameOutput
+    }
+}
+

README.md

@@ -73,6 +73,13 @@ Get-UGitExtension is built using [Piecemeal](https://github.com/StartAutomating/
 ugit comes packed with many examples.
 You might want to try giving some of these a try.
 
+### Git.Blame Example 1
+
+
+~~~PowerShell
+    git blame ugit.psd1
+~~~
+
 ### Git.Branch Example 1
 
 
@@ -392,6 +399,9 @@ You might want to try giving some of these a try.
 Most extensions handle output from a single git command.
 
 
+* [Git Blame](docs/Git.Blame-Extension.md)
+
+ 
 * [Git Branch](docs/Git.Branch-Extension.md)
 
 
@@ -472,6 +482,9 @@ It will attempt to locate any output specified by -o and return it as a file or
 ugit also allows you to extend the input for git.
 
 
+* [Git Blame Input](docs/Git.Blame.Input-Extension.md)
+
+ 
 * [Git Clone Input](docs/Git.Clone.Input-Extension.md)
 
 

Types/git.blame/PSTypeName.txt

@@ -0,0 +1 @@
+git.blame

Types/git.blame/get_Log.ps1

@@ -0,0 +1,4 @@
+
+Push-Location $this.GitRoot
+git log $this.CommitHash -NumberOfCommits 1
+Pop-Location

Types/git.blame/git.blame.format.ps1

@@ -0,0 +1,4 @@
+Write-FormatView -TypeName git.blame -GroupByProperty GitRoot -Property CommitHash, Author, CommitDate, Line, Content -AlignProperty @{    
+    'Line' = 'Right'
+    'Content' = 'Left'
+}

Use-Git.ps1

@@ -319,7 +319,7 @@
                 if (-not $script:RepoRoots[$dir] -and      # If we did not have a repo root
                     -not ($gitArgument -match "(?>$($RepoNotRequired -join '|'))") # and we are not doing an operation that does not require one
                 ) {
-                    Write-Warning "'$($dir)' is not a git repository" # warn that there is no repo (#21)
+                    Write-Verbose "'$($dir)' is not a git repository" # write that there is no repo to verbose (#21 , #198, #204)
                     Pop-Location # pop back out of the directory
                     continue nextDirectory # and continue to the next directory.
                 }

docs/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 0.4.2:
+
+* git blame support (#192, #193, #199, #201)
+* Use-Git will write to Verbose, not warning, when a directory is not a repository (#198, #204)
+* ugit PSA improvements (#189, #205, #206, #207)
+
+---
+
 ## 0.4.1:
 
 * New Git Command Support:

docs/Git.Blame-Extension.md

@@ -0,0 +1,38 @@
+Extensions/Git.Blame.UGit.extension.ps1
+---------------------------------------
+
+
+
+
+### Synopsis
+Parses git blame output
+
+
+
+---
+
+
+### Description
+
+Parses the output of git blame.
+
+
+
+---
+
+
+### Examples
+> EXAMPLE 1
+
+```PowerShell
+git blame ugit.psd1
+```
+
+
+---
+
+
+### Syntax
+```PowerShell
+Extensions/Git.Blame.UGit.extension.ps1 [<CommonParameters>]
+```