Skip to content

Documentation for Gurli

This is the documentation page for gurli, which is a program to create files, using a set of templates and the respective data.

Supported Templates and Formats

In terms of supported template systems, gurli has:

  • text/template → The template format provided by the standard library, with identifier golang;
  • raymond → A template format similar to handlebars with identifier raymond;
  • jet → A template format with identifier jet;
  • liquid → A template format similar to shopify liquid with identifier liquid.

In terms of data formats, the following formats are supported:

  • bson;
  • cbor;
  • json;
  • plist;
  • toml;
  • xml;
  • yaml.

A list of available functions for use in the templates is available in this page.

Bookmarks

Gurli also has a notion of bookmarks, which is a way to associate a name to a template and they are provided in two flavours:

  • link bookmarks → These bookmarks store a link to the template path and reference it directly, meaning that if the template file is moved or deleted, the template becomes stale;
  • embed bookmarks → These bookmarks directly store the template content in it, they take more space but do not have any dependency on the original template file, on the other hand they aren’t updated when the template file changes.

Commands

The commands available in gurli are described here.