• Stars
    star
    3,730
  • Rank 11,186 (Top 0.3 %)
  • Language
    F#
  • License
    MIT License
  • Created about 9 years ago
  • Updated 13 days ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The F# compiler, F# core library, F# language service, and F# tooling integration for Visual Studio

The F# compiler, F# core library, and F# editor tools

Build Status Help Wanted

You're invited to contribute to future releases of the F# compiler, core library, and tools. Development of this repository can be done on any OS supported by .NET.

You will also need .NET SDK installed from here, exact version can be found in the global.json file in the root of the repository.

Contributing

Quickstart on Windows

Build from the command line:

build.cmd

The build depends on an installation of Visual Studio. To build the compiler without this dependency use:

build.cmd -noVisualStudio

After it's finished, open either FSharp.sln or VisualFSharp.sln in your editor of choice. The latter solution is larger but includes the F# tools for Visual Studio and its associated infrastructure.

Quickstart on Linux or macOS

Build from the command line:

./build.sh

After it's finished, open FSharp.sln in your editor of choice.

Documentation for contributors

  • The Compiler Documentation is essential reading for any larger contributions to the F# compiler codebase and contains links to learning videos, architecture diagrams, and other resources.

  • The same docs are also published as The F# Compiler Guide. It also contains the public searchable docs for FSharp.Compiler.Service component.

  • See DEVGUIDE.md for more details on configurations for building the codebase. In practice, you only need to run build.cmd/build.sh.

  • See TESTGUIDE.md for information about the various test suites in this codebase and how to run them individually.

Documentation for F# community

  • The F# Documentation is the primary documentation for F#. The source for the content is here.

  • The F# Language Design Process is the fundamental design process for the language, from suggestions to completed RFCs. There are also tooling RFCs for some topics where cross-community co-operation and visibility are most useful.

  • The F# Language Specification is an in-depth description of the F# language. This is essential for understanding some behaviors of the F# compiler and some of the rules within the compiler codebase. For example, the order and way name resolution happens are specified here, which greatly impacts how the code in Name Resolutions works and why certain decisions are made.

No contribution is too small

Even if you find a single-character typo, we're happy to take the change! Although the codebase can feel daunting for beginners, we and other contributors are happy to help you along.

Per-build NuGet packages

7.0.40x series

FSharp.Compiler.Service 43.7.400-preview

<add key="fsharp-prerelease" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet7/nuget/v3/index.json" />

8.0.10x series

FSharp.Compiler.Service 43.8.100-preview

<add key="fsharp-prerelease" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json" />

NOTE: Official NuGet releases of FCS and FSharp.Core are synched with SDK releases (on purpose - we want to be in sync). Nightly packages release to Azure feeds on every successful insertion.

Branches

These are the branches in use:

  • main

    • Almost all contributions go here.
    • Able to be built, installed and used in the latest public Visual Studio release.
    • May contain updated F# features and logic.
    • Used to build nightly VSIX (see above).
  • release/dev15.9

    • Long-term servicing branch for VS 2017 update 15.9.x. We do not expect to service that release, but if we do, that's where the changes will go.
  • release/dev17.x

    • Latest release branch for the particular point release of Visual Studio.
    • Incorporates features and fixes from main up to a particular branch point, then selective cherry-picks.
    • May contain new features that depend on new things or fixes in the corresponding forthcoming Visual Studio release.
    • Gets integrated back into main once the corresponding Visual Studio release is made.

F# language and core library evolution

Evolution of the F# language and core library follows a process spanning two additional repositories. The process is as follows:

  1. Use the F# language suggestions repo to search for ideas, vote on ones you like, submit new ideas, and discuss details with the F# community.
  2. Ideas that are "approved in principle" are eligible for a new RFC in the F# language design repo. This is where the technical specification and discussion of approved suggestions go.
  3. Implementations and testing of an RFC are submitted to this repository.

License

This project is subject to the MIT License. A copy of this license is in License.txt.

Code of Conduct

This project has adopted the Contributor Covenant code of conduct to clarify expected behavior in our community. You can read it at CODE_OF_CONDUCT.

Get In Touch

Members of the F# Software Foundation are invited to the FSSF Slack. You can find support from other contributors in the #compiler and #editor-support channels.

Additionally, you can use the #fsharp tag on Twitter if you have general F# questions, including about this repository. Chances are you'll get multiple responses.

About F#

If you're curious about F# itself, check out these links:

More Repositories

1

aspnetcore

ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.
C#
33,217
star
2

maui

.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
C#
21,364
star
3

core

Home repository for .NET Core
PowerShell
19,308
star
4

roslyn

The Roslyn .NET compiler provides C# and Visual Basic languages with rich code analysis APIs.
C#
18,257
star
5

corefx

This repo is used for servicing PR's for .NET Core 2.1 and 3.1. Please visit us at https://github.com/dotnet/runtime
17,793
star
6

runtime

.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.
C#
13,703
star
7

coreclr

CoreCLR is the runtime for .NET Core. It includes the garbage collector, JIT compiler, primitive data types and low-level classes.
12,807
star
8

efcore

EF Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations.
C#
12,774
star
9

AspNetCore.Docs

Documentation for ASP.NET Core
C#
12,270
star
10

csharplang

The official repo for the design of the C# programming language
C#
10,743
star
11

BenchmarkDotNet

Powerful .NET library for benchmarking
C#
9,929
star
12

orleans

Cloud Native application framework for .NET
C#
9,460
star
13

blazor

Blazor moved to https://github.com/dotnet/aspnetcore
PowerShell
9,348
star
14

machinelearning

ML.NET is an open source and cross-platform machine learning framework for .NET.
C#
8,456
star
15

reactive

The Reactive Extensions for .NET
C#
6,428
star
16

wpf

WPF is a .NET Core UI framework for building Windows desktop applications.
C#
6,346
star
17

tye

Tye is a tool that makes developing, testing, and deploying microservices and distributed applications easier. Project Tye includes a local orchestrator to make developing microservices easier and the ability to deploy microservices to Kubernetes with minimal configuration.
C#
5,311
star
18

msbuild

The Microsoft Build Engine (MSBuild) is the build platform for .NET and Visual Studio.
C#
5,073
star
19

winforms

Windows Forms is a .NET UI framework for building Windows desktop applications.
C#
4,179
star
20

MQTTnet

MQTTnet is a high performance .NET library for MQTT based communication. It provides a MQTT client and a MQTT server (broker). The implementation is based on the documentation from http://mqtt.org/.
C#
4,070
star
21

machinelearning-samples

Samples for ML.NET, an open source and cross-platform machine learning framework for .NET.
PowerShell
4,061
star
22

dotnet-docker

Docker images for .NET and the .NET Tools.
Dockerfile
4,033
star
23

docs

This repository contains .NET Documentation.
Dockerfile
3,921
star
24

Open-XML-SDK

Open XML SDK by Microsoft
C#
3,788
star
25

docfx

Static site generator for .NET API documentation.
C#
3,663
star
26

Silk.NET

The high-speed OpenGL, OpenCL, OpenAL, OpenXR, GLFW, SDL, Vulkan, Assimp, WebGPU, and DirectX bindings library your mother warned you about.
C#
3,567
star
27

cli

The .NET Core command-line (CLI) tools, used for building .NET Core apps and libraries through your development flow (compiling, NuGet package management, running, testing, ...).
3,494
star
28

command-line-api

Command line parsing, invocation, and rendering of terminal output.
C#
3,095
star
29

standard

This repo is building the .NET Standard
3,073
star
30

aspnet-api-versioning

Provides a set of libraries which add service API versioning to ASP.NET Web API, OData with ASP.NET Web API, and ASP.NET Core.
C#
2,941
star
31

roslynator

Roslynator is a set of code analysis tools for C#, powered by Roslyn.
C#
2,913
star
32

corert

This repo contains CoreRT, an experimental .NET Core runtime optimized for AOT (ahead of time compilation) scenarios, with the accompanying compiler toolchain.
C#
2,910
star
33

samples

Sample code referenced by the .NET documentation
C#
2,896
star
34

vscode-csharp

Official C# support for Visual Studio Code
TypeScript
2,788
star
35

try

Try .NET provides developers and content authors with tools to create interactive experiences.
TypeScript
2,758
star
36

interactive

.NET Interactive combines the power of .NET with many other languages to create notebooks, REPLs, and embedded coding experiences. Share code, explore data, write, and learn across your apps in ways you couldn't before.
C#
2,636
star
37

sdk

Core functionality needed to create .NET Core projects, that is shared between Visual Studio and CLI
C#
2,438
star
38

extensions

This repository contains a suite of libraries that provide facilities commonly needed when creating production-ready applications.
C#
2,361
star
39

maui-samples

Samples for .NET Multi-Platform App UI (.NET MAUI)
C#
2,219
star
40

Docker.DotNet

🐳 .NET (C#) Client Library for Docker API
C#
2,140
star
41

pinvoke

A library containing all P/Invoke code so you don't have to import it every time. Maintained and updated to support the latest Windows OS.
C#
2,079
star
42

spark

.NET for Apache® Spark™ makes Apache Spark™ easily accessible to .NET developers.
C#
1,993
star
43

iot

This repo includes .NET Core implementations for various IoT boards, chips, displays and PCBs.
C#
1,932
star
44

format

Home for the dotnet-format command
C#
1,736
star
45

wcf

This repo contains the client-oriented WCF libraries that enable applications built on .NET Core to communicate with WCF services.
C#
1,664
star
46

Comet

Comet is an MVU UIToolkit written in C#
C#
1,623
star
47

templating

This repo contains the Template Engine which is used by dotnet new
C#
1,536
star
48

llilc

This repo contains LLILC, an LLVM based compiler for .NET Core. It includes a set of cross-platform .NET code generation tools that enables compilation of MSIL byte code to LLVM supported platforms.
C++
1,512
star
49

infer

Infer.NET is a framework for running Bayesian inference in graphical models
C#
1,500
star
50

dotNext

Next generation API for .NET
C#
1,485
star
51

EntityFramework.Docs

Documentation for Entity Framework Core and Entity Framework 6
PowerShell
1,477
star
52

roslyn-analyzers

C#
1,471
star
53

corefxlab

This repo is for experimentation and exploring new ideas that may or may not make it into the main corefx repo.
C#
1,462
star
54

ef6

This is the codebase for Entity Framework 6 (previously maintained at https://entityframework.codeplex.com). Entity Framework Core is maintained at https://github.com/dotnet/efcore.
C#
1,400
star
55

installer

.NET SDK Installer
C#
1,261
star
56

codeformatter

Tool that uses Roslyn to automatically rewrite the source to follow our coding styles
C#
1,235
star
57

ResXResourceManager

Manage localization of all ResX-Based resources in one central place.
C#
1,235
star
58

Nerdbank.GitVersioning

Stamp your assemblies, packages and more with a unique version generated from a single, simple version.json file and include git commit IDs for non-official builds.
C#
1,223
star
59

announcements

Subscribe to this repo to be notified of Announcements and changes in .NET Core.
1,220
star
60

MobileBlazorBindings

Experimental Mobile Blazor Bindings - Build native and hybrid mobile apps with Blazor
C#
1,182
star
61

runtimelab

This repo is for experimentation and exploring new ideas that may or may not make it into the main dotnet/runtime repo.
1,181
star
62

ILMerge

ILMerge is a static linker for .NET Assemblies.
C#
1,175
star
63

try-convert

Helping .NET developers port their projects to .NET Core!
C#
1,137
star
64

sourcelink

Source Link enables a great source debugging experience for your users, by adding source control metadata to your built assets
C#
1,136
star
65

diagnostics

This repository contains the source code for various .NET Core runtime diagnostic tools and documents.
C++
1,092
star
66

upgrade-assistant

A tool to assist developers in upgrading .NET Framework applications to .NET 6 and beyond
C#
982
star
67

project-system

The .NET Project System for Visual Studio
C#
945
star
68

try-samples

C#
920
star
69

TorchSharp

A .NET library that provides access to the library that powers PyTorch.
C#
891
star
70

designs

This repo is used for reviewing new .NET designs.
C#
843
star
71

ClangSharp

Clang bindings for .NET written in C#
C#
840
star
72

crank

Benchmarking infrastructure for applications
C#
819
star
73

LLVMSharp

LLVM bindings for .NET Standard written in C# using ClangSharp
C#
805
star
74

DataGridExtensions

Modular extensions for the WPF DataGrid control
C#
754
star
75

SqlClient

Microsoft.Data.SqlClient provides database connectivity to SQL Server for .NET applications.
C#
728
star
76

intro-to-dotnet-web-dev

Get Started as a Web Developer with .NET, C#, and ASP.NET Core
C#
666
star
77

Microsoft.Maui.Graphics

An experimental cross-platform native graphics library.
C#
657
star
78

HttpRepl

The HTTP Read-Eval-Print Loop (REPL) is a lightweight, cross-platform command-line tool that's supported everywhere .NET Core is supported and is used for making HTTP requests to test ASP.NET Core web APIs and view their results.
C#
651
star
79

arcade

Tools that provide common build infrastructure for multiple .NET Foundation projects.
C#
642
star
80

csharp-notebooks

Get started learning C# with C# notebooks powered by .NET Interactive and VS Code.
Jupyter Notebook
629
star
81

performance

This repo contains benchmarks used for testing the performance of all .NET Runtimes
F#
620
star
82

Microsoft.Maui.Graphics.Controls

Experimental Microsoft.Maui.Graphics.Controls - Build drawn controls (Cupertino, Fluent and Material)
C#
608
star
83

Scaffolding

Code generators to speed up development.
C#
596
star
84

csharpstandard

Working space for ECMA-TC49-TG2, the C# standard committee.
C#
596
star
85

dotnet-console-games

Game examples implemented as .NET console applications primarily for providing education and inspiration. :)
C#
569
star
86

cli-lab

A guided tool will be provided to enable the controlled clean up of a system such that only the desired versions of the Runtime and SDKs remain.
C#
563
star
87

dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
C#
558
star
88

dotnet-docker-samples

The .NET Core Docker samples have moved to https://github.com/dotnet/dotnet-docker/tree/master/samples
C#
545
star
89

dotnet-monitor

This repository contains the source code for .NET Monitor - a tool that allows you to gather diagnostic data from running applications using HTTP endpoints
C#
527
star
90

WatsonTcp

WatsonTcp is the easiest way to build TCP-based clients and servers in C#.
C#
518
star
91

Nerdbank.Streams

Specialized .NET Streams and pipes for full duplex in-proc communication, web sockets, and multiplexing
C#
514
star
92

Kerberos.NET

A Kerberos implementation built entirely in managed code.
C#
490
star
93

blazor-samples

HTML
483
star
94

buildtools

Build tools that are necessary for building the .NET Core projects
479
star
95

roslyn-sdk

Roslyn-SDK templates and Syntax Visualizer
C#
470
star
96

core-setup

Installer packages for the .NET Core runtime and libraries
455
star
97

training-tutorials

Getting started tutorials for C# and ASP.NET
C#
401
star
98

razor

Compiler and tooling experience for Razor ASP.NET Core apps in Visual Studio, Visual Studio for Mac, and VS Code.
C#
390
star
99

linker

C#
380
star
100

sign

Code Signing CLI tool supporting Authenticode, NuGet, VSIX, and ClickOnce
C#
374
star