Find-Lines.ps1

<#
.SYNOPSIS
Searches a specific subset of files for lines matching a pattern.

.OUTPUTS
Microsoft.PowerShell.Commands.MatchInfo with each match found.

.FUNCTIONALITY
Search and replace

.EXAMPLE
Find-Lines 'using System;' *.cs "$env:USERPROFILE\Documents\Visual Studio*\Projects" -CaseSensitive -List

This command searches all of the .cs files in the Projects directory (or directories) and subdirectories,
returning the matches.
#>

#Requires -Version 3
[CmdletBinding(DefaultParameterSetName='Default')][OutputType([Microsoft.PowerShell.Commands.MatchInfo])] Param(
<#
Specifies the text to find. Type a string or regular expression.
If you type a string, use the SimpleMatch parameter.
#>
[Parameter(Position=0,Mandatory=$true)][string[]] $Pattern,
# Specifies wildcard filters that file names must match.
[Parameter(Position=1)][string[]] $Filters,
<#
Specifies a path to one or more locations. Wildcards are permitted.
The default location is the current directory (.).
#>
[Parameter(Position=2)][string[]] $Path,
# Wildcard patterns files must match one of (slower than Filter).
[string[]] $Include,
# Wildcard patterns files must not match any of.
[string[]] $Exclude = @('*.dll','*.exe','*.pdb','*.bin','*.cache','*.png','*.gif','*.jpg','*.ico','*.psd','*.obj','*.iso',
# Makes matches case-sensitive. By default, matches are not case-sensitive.
	'*.docx','*.xls','*.xlsx','*.pdf','*.rtf','*.swf','*.chm','*.ttf','*.woff','*.eot','*.otf','*.mdf','*.ldf','*.pack',
	'*.zip','*.gz','*.tgz','*.jar','*.nupkg','*.vspscc','*.vsmdi','*.vssscc','*.vsd','*.vscontent','*.vssettings','*.suo',
	'*.dbmdl','*.tdf','*.optdata','*.sigdata','*.lib'),
[switch] $CaseSensitive,
<#
Returns only the first match in each input file.
By default, Select-String returns a MatchInfo object for each match it finds.
#>
[switch] $List,
# Finds text that does not match the specified pattern.
[switch] $NotMatch,
<#
Uses a simple match rather than a regular expression match.
In a simple match, Select-String searches the input for the text in the Pattern parameter.
It does not interpret the value of the Pattern parameter as a regular expression statement.
#>
[switch] $SimpleMatch,
# Disables searching subdirectories.
[switch] $NoRecurse,
# Displays a grid of matches to select a subset from.
[Alias('Pick')][switch] $ChooseMatches,
# Invokes files that contain matches.
[Parameter(ParameterSetName='Open')][Alias('View')][switch] $Open,
# Returns git blame info for matching lines.
[Parameter(ParameterSetName='Blame')][Alias('Who')][switch] $Blame
)

function ConvertTo-DateTimeOffset([Parameter(Position=0)][int] $UnixTime,[Parameter(Position=1)][string] $TimeZone)
{
    [DateTimeOffset]::Parse(([DateTime]'1970-01-01Z').AddSeconds($UnixTime).ToString('s')+$TimeZone)
}

$culturetextinfo = (Get-Culture).TextInfo
function Get-LineBlameInfo([Parameter(Position=0)][string] $Path,[Parameter(Position=1)][int] $LineNumber)
{
    Split-Path $Path |Push-Location
    $lineinfo = [Collections.Generic.List[string]]@(git blame -l -p -L "$LineNumber,$LineNumber" -- $Path)
    Pop-Location
    if(!$lineinfo.Count) {return}
    ($sha1,$linetext) = ($lineinfo[0],$lineinfo[$lineinfo.Count -1])
    $lineinfo.RemoveAt($lineinfo.Count -1)
    $lineinfo.RemoveAt(0)
    $linehash = @{SHA1 = $sha1; Line = $linetext}
    $lineinfo |
        ForEach-Object {
            ($k,$v)= $_ -split ' ',2
            $linehash.Add(($culturetextinfo.ToTitleCase($k) -replace '-',''),$v)
        }
    $linehash['AuthorTime'] = ConvertTo-DateTimeOffset $linehash['AuthorTime'] $linehash['AuthorTz']
    $linehash.Remove('AuthorTz')
    $linehash['CommitterTime'] = ConvertTo-DateTimeOffset $linehash['CommitterTime'] $linehash['CommitterTz']
    $linehash.Remove('CommitterTz')
    [pscustomobject]$linehash
}

# set up splatting
$lsopt = @{Recurse=!$NoRecurse;File=$true}
if($Path) { $lsopt.Path=$Path }
if($Include) { $lsopt.Include=$Include }
if($Exclude) { $lsopt.Exclude=$Exclude }
$ssopt = @{'Pattern'=$Pattern}
if($CaseSensitive) { $ssopt.CaseSensitive=$true }
if($List) { $ssopt.List=$true }
if($NotMatch) { $ssopt.NotMatch=$true }
if($SimpleMatch) { $ssopt.SimpleMatch=$true }
# the filter parameter is much faster than the include parameter
$lookin = if($Filters) { $Filters|ForEach-Object {Get-ChildItem @lsopt -Filter $_} } else { Get-ChildItem @lsopt }
# TODO: Manually handle Include and Exclude for the FullName.
$found = Select-String -Path $lookin @ssopt
if($ChooseMatches) { $found = $found |Out-GridView -Title "Select matches: $Pattern $Filters $Path" -PassThru }
switch($PSCmdlet.ParameterSetName)
{
    Default { $found }
    Open    { $found |Invoke-Item }
    Blame   { $found |ForEach-Object {Get-LineBlameInfo $_.Path $_.LineNumber} }
}