FxCop v17 (Visual Studio 2022) rule extensions and related code. A project named for that well known police constable of yesteryear. Intended for use with F#, since we don't have Roslyn analyzers there.
An executable, DixonCmd.exe that injects a netstandard2.0 compatible platform definition into the FxCopCmd process and launches an analysis session.
JustifySuppressionRule(Dixon.Design#DX0001), the "Hello, World!" of FxCop rules. A port of the well travelled example rule to ensure thatSuppressMessageattributes include a justification. See e.g. http://www.binarycoder.net/fxcop/html/ex_specifysuppressmessagejustification.htmlReraiseCorrectlyRule(Dixon.Design#DX0002) : onlythrowan exception you've just created
The package contains a subfolder tools which contains everything, including a further subfolder Rules containing just the rules assembly.
- Copy FxCop from under Visual Studio to some (
.gitignored as required) location within your project. - Copy the Dixon NuGet package
toolsfolder into the same directory as above (or just theRulessubfolder into theRulessubfolder ifnetstandard2.0support isn't relevant; or omit theRulessubfolder if those are not wanted) - Copy the
FxCopCmd.exe.configtoDixonCmd.exe.configifnetstandard2.0support is desired. - You may need to copy the
FSharp.Core.dllassembly fromtoolsanyway if you're not an a machine with F# development -- do this if there's an obvious failure to load because it's not there.
Now for framework assemblies use FxCopCmd.exe as before from the new location, where it will pick up the Dixon rules. For netstandard2.0 assemblies, use DixonCmd.exe /platform=<path to DotNet sdk ref subfolder containing netstandard2.0.dll> e.g. DixonCmd.exe "/plat:C:\Program Files\dotnet\sdk\6.0.101\ref"
I've used a dummy .csproj to install tooling packages that aren't dotnet tool items (things like unit test console runners for .net Framework, or PowerShell modules such as Pester) to a non-cache location using dotnet restore --packages
Your build script can parse the .csproj as XML to find the version under the altcode.dixon folder
It's at %ProgramFiles\Microsoft Visual Studio\2022\<edition>\Team Tools\Static Analysis Tools\FxCop or
%ProgramFiles(x86)\Microsoft Visual Studio\2019\<edition>\Team Tools\Static Analysis Tools\FxCop; to automate the process in your build scripts, it's simplest to use the BlackFox.VsWhere package --
BlackFox.VsWhere.VsInstances.getAll()to get installed versions- select one of those with
InstallationVersionproperty major version 16 or 17 as appropriate to your process - FxCop is in folder
Team Tools/Static Analysis Tools/beneath theInstallationPathproperty
As well as needing the path of the netstandard2.0.dll in the build environment, the process will need to be fed with the non-platform dependencies through the /d: command line argument e.g.
"/d:<nuget cache>/packages\<package name>/<package version>/lib/netstandard2.0"
Some dependency lacks will be obvious from the error messages, but some are subtle and need to be deduced from the exception details in the FxCop report file. In particular it may be necessary to add .net Framework 4.7.2 (or at least its reference asseblies to handle resolution failures with obvious platform functionality)
Here's the recipe I use, including appropriate sections of Fake.build scripting.
Assumes VS2022 build environment
- dotnet tool restore
- dotnet run --project .\Build\Setup.fsproj
- dotnet run --project .\Build\Build.fsproj
The F# focus will include making rule variants that are more F# aware, to separate out the compiler generated clutter from the code the developer can affect -- avoiding smothering the code in [<SuppressMessage>], or throwing rules out for poor signal to noise. But there will inevitably be some more originals.
| Build | GitHub |