Commands
Initialize a Boilerplate Library
Call this command to initialize a new Boil template directory. This generates a .boilerplate
folder at the root of your current directory. It contains an example template folder called component
as well as a global.args.yml
file and a template function.
See here for more details on the template folder structure, syntax and purpose of the *.args.yml
files.
USAGE
$ boil init
OPTIONS
-h, --help show CLI help
Create a New Template
Create a new template directory using this command.
It will generate a new folder in the .boilerplate
directory, with the provided name, as well as a local.args.yml
file. You can optionally pass in a list of arguments to pre-fill the local.args.yml
file with settings for local arguments.
USAGE
$ boil create [NAME]
ARGUMENTS
NAME template name
OPTIONS
-a, --args=args local template args
-h, --help show CLI help
Here's some examples.
# template with no arguments (can be added later)
boil create person
# template with name, surname & age arguments
boil create person --args name,surname,age
boil create person -a name,surname,age
Create a New Template Function
Create a new boilerplate template function.
This generates a *.js
file in the .boilerplate
directory with the provided name.
USAGE
$ boil create-function [NAME]
ARGUMENTS
NAME template function name
OPTIONS
-h, --help show CLI help
Here's an example.
# creates a function called timestamp.js
boil create-function timestamp
Cook Up Some Boilerplate
This is what you'll do when you want to generate boilerplate from one of your templates.
After entering the command below, the CLI will prompt you where you'd like to save the generated boilerplate files and/or folders.
USAGE
$ boil up TEMPLATE
ARGUMENTS
TEMPLATE call up a template defined in the '.boilerplate' directory
OPTIONS
-h, --help show CLI help
Here's some examples.
boil up component --name App --filetype js
boil up component -n App -ft js
Don't worry if you can't remember what argument inputs are required for a template. If you simply type boil up [TEMPLATE NAME]
(without any arguments) then you'll get a summary table of all required inputs.
Here's an example output.
$ boil up component
⛔ your args don't match the template requirements
boil up component ARGS
Name [--] Shorthand [-] Default Options Description
name n undefined undefined component name
filetype ft js [ 'js', 'py', 'go' ] file type
List All Templates
If you want to see a list of all templates in your boilerplate directory then use the command below.
USAGE
$ boil list
OPTIONS
-h, --help show CLI help