hexlabsio / kloudformation

Create Typesafe Cloudformation Templates with Kotlin

KloudFormation

For Full Reference Documentation goto: https://hexlabsio.github.io/kloudformation/

KloudFormation

KloudFormation is a one-to-one mapping of Amazon's CloudFormation generated into a Kotlin library allowing users to write type safe stacks in Kotlin.

KloudFormation can be invoked in many ways allowing any project to use it, not just Kotlin projects.

Benefits Include

• Type Safety
• Code Completion
• Stacks as Code
• Modular Templating
• Up to Date

This is what it looks like

val template = KloudFormationTemplate.create {
    val topic = topic()
    bucket {
        bucketName(topic.TopicName())
    }
}

This is what it Produces

AWSTemplateFormatVersion: "2010-09-09"
Resources:
    Topic:
     Type: "AWS::SNS::Topic"
    Bucket:
     Type: "AWS::S3::Bucket"
     Properties:
       BucketName:
         Fn::GetAtt:
         - "Topic"
         - "TopicName"

Get Started

Any project can use KloudFormation. To get the best experience, it is recommended to use an IDE with code completion like IntelliJ IDEA

Get Started with Gradle, Maven, or No Build Tool