Handlebars templates for config files.

Download the latest release binary for your system from the Releases page. Note that there are different binaries for various architectures on Linux, Alpine, macOS, and Windows.

Linux x64 example:

curl -L -o hbs.zip https://github.com/kspearrin/Handlebars.conf/releases/download/v1.3.0/hbs_linux-x64.zip
sudo unzip hbs.zip -d /usr/local/bin && rm hbs.zip
sudo chmod +x /usr/local/bin/hbs

hbs --help

NOTE: Release binaries with the _dotnet suffix are smaller in size, but require the .NET Core runtime to be installed on the host machine.

Handlebars config file: hbs.yaml

templates:
  - src: test.conf.hbs
    dest: test.conf

Source Handlebars template: test.conf.hbs.

Note: Environment variables are available under the env property.

<Section>
    {{env.username}}
</Section>

Run command

hbs -c hbs.yaml

Destination output: test.conf

<Section>
    kyle
</Section>

templates:
  - src: foo.conf.hbs
    dest: foo.conf
  - src: bar.conf.hbs
    dest: bar.conf
  - src: baz.conf.hbs
    dest: baz.conf

Learn more about using Handlebars templates here: https://handlebarsjs.com

You can load Handlebars helpers from the Handlebars.Net Helpers library by specifying helper categories to load in your config file.

Config

helper_categories:
  - String
  - Math
templates:
  - src: test.conf.hbs
    dest: test.conf

Template test.conf.hbs

{{Math.Add 4 5}}

{{#if (String.IsNotNullOrWhitespace env.username)}}
{{String.Append env.username " is awesome."}}
{{/if}}

{{String.Coalesce "" "     " "value" " " "value2"}}

{{#each (String.Split "1,2, 3" ",")}}
Number: {{String Trim .}}
{{/each}}

{{#if (String.Equal env.username "tom")}}
user is tom.
{{else}}
user is {{String.Uppercase env.username}}.
{{/if}}

Result test.conf

9

kyle is awesome.

value

Number: 1
Number: 2
Number: 3

user is KYLE.

You can see this tool in use with Bitwarden's Nginx config here: https://github.com/bitwarden/server/tree/master/docker-unified/hbs