Fabulous.AST

Welcome to Fabulous.AST, an Abstract Syntax Tree (AST) Domain Specific Language (DSL) for F#.

Fabulous.AST leverages Fantomas to generate F# code from AST. This allows you to create F# code that adheres to the Fantomas style guide while providing a simple and expressive way to represent code as a tree of nodes. This approach simplifies programmatic code manipulation and analysis.

Features

• Simplified AST creation for F# code
• Integration with Fantomas for consistent code formatting
• Expressive DSL for representing code structures
• Easy-to-use API for code generation and manipulation

Installation

Install Fabulous.AST via NuGet:

dotnet add package Fabulous.AST

Usage

Let's compare AST creation using Fantomas directly and Fabulous.AST:

Fantomas AST Example

open Fantomas.Core open Fantomas.Core.SyntaxOak open Fantomas.FCS.Text Oak( [], [ ModuleOrNamespaceNode( None, [ BindingNode( None, None, MultipleTextsNode([ SingleTextNode("let", Range.Zero) ], Range.Zero), false, None, None, Choice1Of2(IdentListNode([ IdentifierOrDot.Ident(SingleTextNode("x", Range.Zero)) ], Range.Zero)), None, [], None, SingleTextNode("=", Range.Zero), Expr.Constant(Constant.FromText(SingleTextNode("12", Range.Zero))), Range.Zero ) |> ModuleDecl.TopLevelBinding ], Range.Zero ) ], Range.Zero ) |> CodeFormatter.FormatOakAsync |> Async.RunSynchronously |> printfn "%s"