FsHcl

A typed DSL that generates HCL / Terraform code from F#.

Installation

dotnet add package FsHcl

Minimal Example

open FsHcl.Hcl
open FsHcl.TerraformHcl

hcl {
    resource "aws_s3_bucket" "example" {
        attr "bucket" (str "my-bucket")

        attr "tags" (ofRecord {|
            Environment = "production"
            ManagedBy = "terraform"
        |})
    }

    output "bucket_arn" {
        attr "value" (raw "aws_s3_bucket.example.arn")
    }
}
|> document

Output:

resource "aws_s3_bucket" "example" {
  bucket = "my-bucket"

  tags = {
    Environment = "production"
    ManagedBy   = "terraform"
  }
}
output "bucket_arn" {
  value = aws_s3_bucket.example.arn
}

Documentation

  • Getting Started — Install FsHcl and generate a Terraform resource
  • Values — All value types: strings, numbers, objects, lists, and CLR conversion
  • Syntax — Blocks, attributes, comments, loops, and render options
  • Terraform Helpers — Terraform-specific block builders and meta-arguments
  • Patterns — Project-specific helper functions and conventions

Examples

examples/HelloLambda is a complete working example.