Added Filter.ExcludeLine option

[ArmaanMcleod]

PR Summary

Fix #1992

I've included a Filter.ExcludeLine option.

Sample Test

Describe "block1" { #Line 1
    It "Test1" { #Line 2
        $true | Should -BeTrue
    }
    Context "block2" { #Line 5
        It "Test2" { # Line 6
            $true | Should -BeTrue
        }
        It "Test3" { #Line 9
            $true | Should -BeTrue
        }
    }
}

Setup Code

$pesterConfig = [PesterConfiguration] @{
    Run = @{
        Container = New-PesterContainer -Path C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1
    }
    Output = @{
        Verbosity = "Diagnostic"
    }
}

Test 1

Include Context block
Exclude Test2

$pesterConfig.Filter.Line = "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:5"
$pesterConfig.Filter.ExcludeLine = "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:6"
Invoke-Pester -Configuration $pesterConfig

Output 1

Only Test 3 is run

Test 2

Include Describe, Context and Test2
Exclude Test2

$pesterConfig.Filter.Line = "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:1", "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:5", "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:6"
$pesterConfig.Filter.ExcludeLine = "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:6"
Invoke-Pester -Configuration $pesterConfig

Output 2

Only Test1 and Test3 are run

Test 3

Include Describe
Exclude Context

$pesterConfig.Filter.Line = "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:1"
$pesterConfig.Filter.ExcludeLine = "C:\Users\Armaan\Documents\powershell-dev\sample.Tests.ps1:5"
Invoke-Pester -Configuration $pesterConfig

Output 3

Only Test1 is run

cc @JustinGrote

PR Checklist

• PR has meaningful title
• Summary describes changes
• PR is ready to be merged
  • If not, use the arrow next to Create Pull Request to mark it as a draft. PR can be marked Ready for review when it's ready.
• Tests are added/update (if required)
• Documentation is updated/added (if required)

[ArmaanMcleod]

I believe this is ready for review.

I may have gone a bit overboard on the tests, but was trying to include as many as I can to ensure this option works for different scenarios. I've also included screenshots in the description to highlight the tests cases in the linked issue, which match the behaviour that @JustinGrote is looking for.

[JustinGrote]

LGTM

[nohwnd]

Looks perfect.