b
supports a somewhat rudimentary, though extensible, tempesting system through the use of the templates
command.
To get a list of templates that are available, run:
$ b templates
The output will list one template per line showing the template name and the path to the template file.
By default, b
will list all of the templates that are available to the add
command including overrides from the local .bugs/templates directory. Use the -d
switch to list only the “default” templates from the b
package:
$ b templates -d
Templates can be added to the .bugs directory in a templates folder and customized on a per project basis.
Templates in the .bugs/template directory with the same name as a default template will override the default template. For example, a template file “.bugs/templates/bug.bug.yaml” will be used when the user specifies the “bug” template, rather than the “bug.bug.yaml” located within the b
package.
To customize a template, use the -c switch and specify the template file:
$ b -c bug
b
will then copy the “bug.bug.yaml” to the .bugs/templates directory and the local file can be adjusted for project-specific settings.
The name of the template may also be changed. For example, if you wished to create a “task” template, simply create a new file at “.bugs/templates/task.bug.yaml” and populate it with your new task template content. Then, issuing b templates
should include your new “task” entry in it’s list.
To edit a custom template, you can either open the template file manually by browsing for it within the .bugs/templates directory, or use the -e
switch:
$ b templates -e bug
Which will open the template in the editor configured using the “editor” config option.