Struct hcl::format::FormatterBuilder

pub struct FormatterBuilder<'a, W> { /* private fields */ }

A builder to create a Formatter.

See the documentation of Formatter for a usage example.

Implementations

impl<'a, W> FormatterBuilder<'a, W>

pub fn indent(self, indent: &'a [u8]) -> Self

Set the indent for indenting nested HCL structures.

The default indentation is two spaces.

pub fn dense(self, yes: bool) -> Self

If set, blocks are not visually separated by empty lines from attributes and adjacent blocks.

Default formatting:

attr1 = "value1"
attr2 = "value2"

block1 {}

block2 {}

Dense formatting:

attr1 = "value1"
attr2 = "value2"
block1 {}
block2 {}

pub fn compact(self, yes: bool) -> Self

If set, arrays and objects are formatted in a more compact way.

See the method documation of compact_arrays and compact_objects.

pub fn compact_arrays(self, yes: bool) -> Self

Controls the array formatting.

By default, array elements are separated by newlines:

array = [
  1,
  2,
  3,
]

When compact array formatting is enabled no newlines are inserted between elements:

array = [1, 2, 3]

pub fn compact_objects(self, yes: bool) -> Self

Controls the object formatting.

By default, object items are separated by newlines:

object = {
  one = "foo"
  two = "bar"
  three = "baz"
}

When compact object formatting is enabled no newlines are inserted between items:

object = { one = "foo", two = "bar", three = "baz" }

pub fn build(self, writer: W) -> Formatter<'a, W>

Consumes the FormatterBuilder and turns it into a Formatter which writes HCL to the provided writer.