pxlbros/lightncandy-cli

A PHP CLI wrapper for the mustache/handlebars PHP implementation lightncandy to aid build processes.

LightnCandy-CLI

LightnCandy-CLI is a CLI wrapper around the PHP implementation of mustache/handlebars LightnCandy. This CLI tool can be used in your build process to compile mustache/handlebars templates to PHP to be used with the LightnCandy library or on their own., _(*1)

Installation

LightnCandy-CLI is meant to be used as a CLI tool and can be globally installed with composer like so: composer global require pxlbros/lightncandy-cli Make sure you have ~/.composer/vendor/bin/ in your path., _(*2)

You can also install LightnCandy-CLI into your project directory and run it straight from the vendor folder if you want to., _(*3)

Usage

Basic

The first and only unamed argument is a path to the template file that you wish to compile., _(*4)

$ lightncandy path/to/template.hbs, _(*5)

If omitted, LightnCandy-CLI will use STDIN as the template. This is usefull because you can pipe input into the utility., _(*6)

$ echo 'Hello {{name}}!' | lightncandy, _(*7)

By default LightnCandy-CLI will pipe the compiled template to STDOUT but you can also write the output to disk by providing a path., _(*8)

$ lightncandy path/to/template.hbs -o path/to/output.php, _(*9)

LightnCandy Options

LightnCandy supports many flags that can be used to configure how it compiles your templates. A list of these options and what they do can be found on the page for the LightnCandy library. You can toggle them like so:, _(*10)

$ lightncandy path/to/template.hbs --FLAG_BARE --FLAG_HANDLEBARSJS, _(*11)

You can also use $ lightncandy --help to see a list of availible options and their descriptions in your command line., _(*12)

Other Options

basedir

-b/--basedir "path/to/partials/directory/ path/to/different/dir" Space seperted list of directory paths containing partial templates., _(*13)

helpers

-p/--helpers "path/to/helpers/directory/ path/to/different/dir" Space seperated list of directory paths containing helper functions., _(*14)

blockhelpers

-k/--blockhelpers "path/to/blockhelpers/directory/ path/to/different/dir" Space seperated list of directory paths containing block helper functions., _(*15)

hbhelpers

-h/--hbhelpers "path/to/hbhelpers/directory/ path/to/different/dir" Space seperated list of directory paths containing handlebars style helper functions., _(*16)

fileext

-e/--fileext ".tmpl .partial" Space seperated list of file extensions for template files., _(*17)

render

-r/--render If provided, will run the compiled template and will output the result instead., _(*18)

data

-d/--data JSON string to pass to the rendering function if the render flag is provided., _(*19)

compress

-c/--compress Compress the output to reduce file size by around 30%., _(*20)