hcl

HCL

Ported from https://github.com/hashicorp/hcl

HCL (HashiCorp Configuration Language) is a configuration language built by HashiCorp. The goal of HCL is to build a structured configuration language that is both human and machine friendly for use with command-line tools, but specifically targeted towards DevOps tools, servers, etc.

HCL is also fully JSON compatible. That is, JSON can be used as completely valid input to a system expecting HCL. This helps makes systems interoperable with other systems.

HCL is heavily inspired by libucl, nginx configuration, and others similar.

Resource

• http://www.terraform.io/docs/configuration/syntax.html
• https://github.com/hashicorp/hcl/blob/master/hcl/parse.y

Syntax

The complete grammar can be found here, if you're more comfortable reading specifics, but a high-level overview of the syntax and grammar are listed here.

• Single line comments start with # or //

• Multi-line comments are wrapped in /* and */

• Values are assigned with the syntax key = value (whitespace doesn't matter). The value can be any primitive: a string, number, boolean, object, or list.

• Strings are double-quoted and can contain any UTF-8 characters. Example: "Hello, World"

• Numbers are assumed to be base 10. If you prefix a number with 0x, it is treated as a hexadecimal. If it is prefixed with 0, it is treated as an octal. Numbers can be in scientific notation: "1e10".

• Boolean values: true, false, on, off, yes, no.

• Arrays can be made by wrapping it in []. Example: ["foo", "bar", 42]. Arrays can contain primitives and other arrays, but cannot contain objects. Objects must use the block syntax shown below.

• Objects and nested objects are created using the structure shown below:

variable "ami" {
    description = "the AMI to use"
}

Licence

The original language is licenced under Mozilla Public License, version 2.0 https://github.com/hashicorp/hcl/blob/master/LICENSE

Whatever that is mine is under MIT.