Closed liamjpeters closed 10 months ago
@microsoft-github-policy-service agree
@bergmeister - 👋 Can I get a review please? Sorry I didn't see a way to add a reviewer myself 😊 Thanks!
Renamed rule from AvoidExclamationPointOperator
to AvoidExclaimOperator
@bergmeister - Thanks for your feedback so far - really helpful 😀. Was there anything else that needs to change for this to be considered for a merge? Anyone else I should be asking for a review from?
Added James as well to review. Other than that I just want to test drive it a bit myself for some exploratory testing as the rule is disabled by default so wouldn't get exercised as part of existing test suite scenarios
Any news on this? I don't really know what my expectations should be, as this is my first contribution to this project - so please feel free to tell me to cool my jets and just be more patient.
I appreciate this PR doesn't introduce some killer feature that will be used by loads of people - but I'm excited for it and don't want the PR to be abandoned. Equally I'm excited to pick up other issues and open more PRs to improve the tool and my own c#, after testing the waters here.
Is there anything I can do to help?
Sorry for the delay @liamjpeters . It's not a bumper feature but because it can run on any PowerShell code, it's easy to miss a case that could result e.g. in a NullReferenceException. But the feature is not enabled by default, which is great to limit blast radius. There's actually one thing you could help with, could you run PSSA with this rule enabled against a more complex script like this one as a one off and check there are no exceptions https://github.com/PowerShell/PowerShell/blob/master/build.psm1 Then happy to merge, the rest of the code looks good to me :-)
@bergmeister - Good idea to run it on a more complex test file.
I've run the existing and updated PSSA against the Powershell project's build file. No exceptions thrown and no difference in execution time (both take an average of 170ms on my machine over multiple runs - even with my additional rule enabled).
Invoke-ScriptAnalyzer -Path .\build.psm1 -Settings @{Rules = @{ 'PSAvoidExclaimOperator' = @{ Enable = $true }}}
The build file has a mix of usages of -not
and !
so is a good candidate. Using a text search there are 33 instances of the "!"
character, 9 of them are within strings or comments (leaving 24 being used as negation).
PSSA with the rule enabled correctly flags the 24 negation instances.
Calling Invoke-ScriptAnalyzer
with -Fix
correctly changes the 24 negation instances.
Anything else you can think I should check - please let me know.
Add a rule to warn about using the exclamation mark (
!
) as the negation operator. Suggests using-not
instead.PR Summary
Add the PSAvoidExclaimOperator rule to warn about the use of
!
for negation. The rule is disabled by default as many people see this as a stylistic preference. Covered by tests .Fixes #1826PR Checklist
.cs
,.ps1
and.psm1
files have the correct copyright headerWIP:
to the beginning of the title and remove the prefix when the PR is ready.