Executes all text inside '%{' '}%' delimiters in the source text with a given program (default: /bin/sh) and inserts the stdout and stderr back into the original text.

More specifically, the text blocks will be given to the program as a positional argument and executed as

<prog> -c <text> [<args> ... ]

Inspired by pp and the rc templating language https://werc.cat-v.org/docs/rc-template-lang.

go install github.com/wlcsm/shpp@latest

• SHPP_COMMAND The command used to execute the codeblock (default: /bin/sh)

Basic usage will be to include the templated file as a positional argument

$ cat template.html
<p>%{echo "Hello, world}%</p>

$ shpp template.html
<p>Hello, world</p>

shpp will read from stdin if no arguments are supplied.

$ shpp < template.html
<p>Hello, world</p>

When the code inside the delimiters is executed, it will have access to STDIN, environment variables, and positional arguments of the parent process.

Passing via stdin

$ cat template.html
<p>%{ cat }%</p>

$ echo 'Hello World' | shpp template.yaml
<p>Hello, world</p>

Passing via environment variables

$ echo '%{echo $MSG}%' | MSG='Hello, world' ./shpp
Hello, world

Passing via positional arguments

$ cat template.html
<p>%{ echo $1, $2 }%</p>

$ echo 'Hello World' | shpp template.yaml 'Hello' 'world'
<p>Hello, world</p>

The "-" character may be used in place of the source file name to signify the template should be read from STDIN. This is useful when needed to provide positional arguments.

$ echo '%{printf $1 $2}%' | shpp - 'Hello,' 'world'
Hello, world

The program used to execute the code blocks may be configured with the SHPP_COMMAND environment variable

$ echo '%{print("Hi")}%' | SHPP_COMMAND="$(which python3)" ./shpp
Hi