handlebars.c
C implementation of handlebars.js, developed in conjunction with php-handlebars and handlebars.php.
The opcode compiler is fully featured, however the VM currently does not implement decorators, and therefore inline partials.
Installation
Nix / NixOS
nix-env -i -f https://github.com/jbboehr/handlebars.c/archive/v1.0.0.tar.gzor, in a .nix file:
(import <nixpkgs> {}).callPackage (import (fetchTarball {
url = https://github.com/jbboehr/handlebars.c/archive/v1.0.0.tar.gz;
sha256 = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
})) {}or, to run as a flake:
nix run github:jbboehr/handlebars.cAlpine Linux
apk add handlebars handlebars-dev handlebars-utilsDebian / Ubuntu
# Install dependencies
sudo apt-get install autoconf automake bison flex gcc libjson-c-dev liblmdb-dev \
libtalloc-dev libyaml-dev libtool m4 make pkg-config
# Install testing dependencies
sudo apt-get install check gdb lcov libpcre3-dev bats
# Compile
git clone https://github.com/jbboehr/handlebars.c.git --recursive
cd handlebars.c
./configure --disable-Werror --disable-testing-exports
make all check
sudo make install
sudo ldconfigOSX via Homebrew
# Install dependencies
brew install autoconf automake bison flex gcc json-c libtool libyaml lmdb pkg-config talloc
# Install testing dependencies
brew install check lcov pcre bats
# Compile
git clone https://github.com/jbboehr/handlebars.c.git --recursive
cd handlebars.c
./configure --disable-Werror --disable-testing-exports
make all check
make installCLI via Docker
# via Docker Hub
docker pull jbboehr/handlebars.c:latest
# via GitHub Packages
docker pull docker.pkg.github.com/jbboehr/handlebars.c/handlebarsc:latestUsage
Usage: handlebarsc [OPTIONS]
Example: handlebarsc -t foo.hbs -D bar.json
Mode options:
-h, --help Show this message
-V, --version Print the version
--execute Execute the specified template (default)
--lex Lex the specified template into tokens
--parse Parse the specified template into an AST
--compile Compile the specified template into opcodes
Input options:
-t, --template=FILE The template to operate on
-D, --data=FILE The input data file. Supports JSON and YAML.
Behavior options:
-n, --no-newline Do not print a newline after execution
--flags=FLAGS The flags to pass to the compiler separated by commas. One or more of:
compat, known_helpers_only, string_params, track_ids, no_escape,
ignore_standalone, alternate_decorators, strict, assume_objects,
mustache_style_lambdas
--no-convert-input Do not convert data to native types (use JSON wrapper)
--partial-loader Specify to enable loading partials dynamically
--partial-path=DIR The directory in which to look for partials
--partial-ext=EXT The file extension of partials, including the '.'
--pool-size=SIZE The size of the memory pool to use, 0 to disable (default 2 MB)
--run-count=NUM The number of times to execute (for benchmarking)
The partial loader will concat the partial-path, given partial name in the template,
and the partial-extension to resolve the file from which to load the partial.
If a FILE is specified as '-', it will be read from STDIN.
via Docker
# via Docker Hub
DOCKER_IMAGE=jbboehr/handlebars.c:latest
# via GitHub Packages
DOCKER_IMAGE=docker.pkg.github.com/jbboehr/handlebars.c/handlebarsc:latest
docker pull ${DOCKER_IMAGE}
# relying on the workdir is probably not stable
docker run \
--rm \
-v "$PWD:/srv" \
${DOCKER_IMAGE} \
--data bench/templates/variables.json \
--template bench/templates/variables.handlebars
cat bench/templates/variables.json | docker run \
--rm -i
-v "$PWD:/srv"
${DOCKER_IMAGE} \
--data - \
--template bench/templates/variables.handlebarsLicense
The library for this project is licensed under the LGPLv2.1 or later. The executable and the test suite are licensed under the AGPLv3.0 or later. handlebars.js is licensed under the MIT license.