README_EXPERIMENTAL.md

Ionide: Experimental FSharp

Enhanced F# Language Features for Visual Studio Code (EXPERIMENTAL VERSION)

Part of the Ionide plugin suite. Read detailed documentation at Ionide docs page.

You can support Ionide development on Open Collective.

Notes

This is the experimental version of Ionide plugin, used to test new features. Can be unstable.

For normal usage, please use the stable Ionide-VSCode: FSharp extension instead.

Requirements

• F# (Windows) - Easiest way to install latest versions of F# on Windows is using VS Build Tools 2017. If you use VS 2017, make sure that you've installed workload adding F# support.

• F# (Linux/MacOS) - F# on non-Windows platform is distributed as part of the mono. Installation guide and recent version of mono can be found on the project webpage and on the F# Software Foundation "Use on Linux" page

• .NET Core SDK - .NET Core is modern, cross-platform implementation of .NET Framework. Ionide is requiring it for set of features such as project modifications or debugging. The core part of SDK is dotnet CLI tool that provides easy way to create, build and run F# projects. What's important - the dotnet tool can be used also to create applications targeting also Full Framework (like net461). For detailed instructions on installing .NET Core, visit official step-by-step installation guide.

• VS Code C# plugin (optional) - Ionide's debugging capabilities relies on the debugger provided by Omnisharp team. To get it install C# extension from VS Code marketplace

• MSBuild 2015 (Windows only, optional) - For old, verbose .fsproj files on Windows MSBuild 2015 (14.0) needs to be additionally installed. You can download it here. However, we highly recommend using new, SDK-based project files.

Features

• Syntax highlighting
• Auto completions
• Error highlighting, error list, and quick fixes based on errors
• Tooltips
• Method parameter hints
• Go to Definition
• Peek Definition
• Find all references
• Highlighting usages
• Rename
• Show symbols in file
• Find symbol in workspace
• Show signature in status bar
• Show signature as CodeLens / LineLens
• Go to MSDN help
• Add open NAMESPACE for symbol
• Match case generator
• Go to #load reference
• Generate comment for the symbol
• Integration with F# Interactive
• Integration with Forge (Project scaffolding and modification)
• Integration with FSharpLint (additional hints and quick fixes)
• Integration with MSBuild (Build, Rebuild, Clean project)
• Solution / project explorer

How to get logs for debugging / issue reporting

1. Enable Logging in User settings with

// FSharp configuration
  // Set the verbosity for F# Language Service Output Channel
  "FSharp.logLanguageServiceRequestsOutputWindowLevel": "DEBUG",

  // Enable logging language service requests (FSAC)  to an output channel, the developer tools console, or both
  "FSharp.logLanguageServiceRequests": "both"

2. Open the Output Panel and switch to the F# Language Service Channel
3. Or Toggle Developer Tools (Help |> Toggle Developer Tools) and open the console tab

How to contribute

See https://github.com/ionide/ionide-vscode-fsharp/blob/master/CONTRIBUTING.md

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.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Sponsors

Ionide couldn't be created without support of Lambda Factory. If your company would be interested in supporting development of Ionide, or acquiring commercial support sent us email - [email protected]

You can also support Ionide development on Open Collective.

Partners

Sponsors

Become a sponsor and get your logo on our README on Github, description in VSCode marketplace and on ionide.io with a link to your site.