fsharp-analyzers 0.39.2

Ionide FSharp.Analyzers.SDK

Library used for building custom analyzers for FSAC / F# editors.

F# analyzers are live, real-time, project based plugins that enables to diagnose source code and surface custom errors, warnings and code fixes into editor. Read more about analyzers here - https://medium.com/lambda-factory/introducing-f-analyzers-772487889429

How to build

1. Install the .NET SDK version specified in global.json
2. dotnet tool restore
3. Open and build in your favorite IDE, or use dotnet build

How to run sample

1. dotnet build -c Release
2. Run the console application:

dotnet run --project src\FSharp.Analyzers.Cli\FSharp.Analyzers.Cli.fsproj -- --project ./samples/OptionAnalyzer/OptionAnalyzer.fsproj --analyzers-path ./artifacts/bin/OptionAnalyzer/release --verbosity d

You can also set up a run configuration of FSharp.Analyzers.Cli in your favorite IDE using similar arguments. This also allows you to debug FSharp.Analyzers.Cli.

Using Analyzers

Checkout our Getting Started guide for analyzer users!

Upgrading with an AI agent

This repository ships an agent skill that upgrades the fsharp-analyzers tool and your analyzer packages to a matching set of versions, re-runs the analyzers and reports what is new. Install it globally with:

npx skills add ionide/FSharp.Analyzers.SDK --skill upgrade-fsharp-analyzers -g

Then ask your agent to "upgrade the F# analyzers" in a repository that uses them.

Writing Analyzers

Checkout our Getting Started guide for analyzer authors!

How to contribute

Imposter syndrome disclaimer: I want your help. No really, I do.

There might be a little voice inside that tells you you're not ready; that you need to do one more tutorial, or learn another framework, or write a few more blog posts before you can help me with this project.

I assure you, that's not the case.

This project has some clear Contribution Guidelines and expectations that you can read here.

The contribution guidelines outline the process that you'll need to follow to get a patch merged. By making expectations and process explicit, I hope it will make it easier for you to contribute.

And you don't just have to write code. You can help out by writing documentation, tests, or even by giving feedback about this work. (And yes, that includes giving feedback about the contribution guidelines.)

Thank you for contributing!

Contributing and copyright

The project is hosted on GitHub where you can report issues, fork the project and submit pull requests.

The library is available under MIT license, which allows modification and redistribution for both commercial and non-commercial purposes.