Fillout

![Crates.io] ![Changelog]

Fillout generates files by filling out placeholders in templates.

I made fillout because I needed to generate one-time DNS quizes consisting of a [zone file] and a questionaire file. However nothing in its design is specific to or specially geared towards zone files or questionaires.

Features

• Dead-simple template syntax. Placeholders are marked up with double curly braces. The template syntax is meant to be on par with your average group mail software.
• Validation. If one of your templates contains a placeholder that isn't present in the data you provide, this is reported as an error and no files are written.
• Integration. The data file is read from STDIN to streamline generating files from dynamically generated data.

Installation

[Install stable Rust and Cargo]:

$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Compile and install fillout using Cargo:

$ cargo install fillout

Usage

For the purpose of this demonstration, create some example data:

$ mkdir templates $ echo 'Lorem {{alpha}} {{beta}} sit.' > templates/first.txt.tmpl $ echo 'Duis {{gamma}} irure {{beta}}.' > templates/second.txt.tmpl $ echo 'alpha, ipsum' > input.data $ echo 'beta, dolor' >> input.data $ echo 'gamma, aute' >> input.data

Generate a set of files into the output directory:

$ mkdir output $ fillout -o output templates/* < input.data $ ls -l output/ total 8K -rw------- 1 mattias mattias 23 apr 18 12:35 first.txt -rw------- 1 mattias mattias 23 apr 18 12:35 second.txt $ cat output/first.txt Lorem ipsum dolor sit. $ cat output/second.txt Duis aute irure dolor.

Now let's try out how the validation works. Add another template with a misspelled placeholder and attempt to generate a new set of files:

``` $ echo 'Dolor magna eget est lorem {{ahpla}}.' > templates/third.txt.tmpl $ fillout -o output templates/* < input.data Error: Failed to validate data file against template-files ["/tmp/templates/first.txt.tmpl", "/tmp/templates/second.txt.tmpl", "/tmp/templates/third.txt.tmpl"]

Caused by: Placeholders used in templates are not defined in data-file: ["ahpla"] $ ls -l output/ total 8K -rw------- 1 mattias mattias 23 apr 18 12:35 first.txt -rw------- 1 mattias mattias 23 apr 18 12:35 second.txt ```

Note that now new files have been created and that the exising files that already existed are unchanged (as indicated by their timestamps and file sizes).

Finally, let's take a look at fillout's own usage documentation:

``` $ fillout --help fillout 0.1.1 Fill out placeholders in templates

Reads a data file and a set of template-files and writes a set of output-files corresponding to the templates files.

Placeholders in the template-files are replaced with values from the data file in the output-files. Each placeholder is marked up in the template-files by its name in double braces. E.g. {{ recipient }}. Whitespace surrounding the name is optional. A single placeholder name may optionally recur multiple times in multiple in multiple template-files. If so, they are replaced with the same value each time.

The data file is a headerless CSV file, read from STDIN. Each record must have two fields - a placeholder-name and a value. The delimiter is an ASCII comma. Leading and trailing whitespace are trimmed from both placeholder-names and values. Records are terminated with CR, LF or CRLF. Fields may be quoted with ASCII double quote characters. If you need to use an ASCII double quote you can escape it by doubling it. If a record starts with a hash character, this line is ignored.

USAGE: fillout [OPTIONS] [TEMPLATE-FILE]...

FLAGS: -h, --help
Prints help information

-V, --version    
        Prints version information

OPTIONS: -o, --output-dir