About

Kapow is a template processor that provides the following directives to support injecting file contents, command output, current date/time, etc in generated files.

Block directives

Directive | Description ---|--- !inc:path | Include file contents; path is relative to its containing file !run:command | Run command and insert stdout

Span directives

Directive | Example | Description ---|---|--- `!now` | 2023-02-22T18:48:02Z | Current date/time in UTC / RFC 3339 `!now:local` | Wed 22 Feb 2023 13:48:02 EST | Current date/time in local timezone `!now:local:%A %H:%M` | Wednesday 13:48 | Current date/time in local timezone and custom format `!now:MST7MDT` | Wed 22 Feb 2023 11:48:02 MST | Current date/time in custom timezone `!now:MST7MDT:%A %H:%M` | Wednesday 11:48 | Current date/time in custom timezone and format `!now:US/Hawaii` | Wed 22 Feb 2023 08:48:02 HST | Current date/time in custom locale `!now:US/Hawaii:%A %H:%M` | Wednesday 08:48 | Current date/time in custom locale and format `!now:UTC:%A %H:%M` | Wednesday 18:48 | Current date/time in UTC and custom format `!now:x` | Xh1LIm2 | Current date/time in "x" format

Usage

text $ kapow -V kapow 2.0.0

```text $ kapow -h KAPOW!

Usage: kapow [OPTIONS] [INPUT_FILES]...

Arguments: [INPUT_FILES]... Input file(s)

Options: -r, --readme Print readme -h, --help Print help -V, --version Print version ```

Example

See the readme task in Makefile.toml:

Changelog

Development

bash cargo install cargo-edit cargo-make cargo-outdated dtg miniserve