Hooks
Hooks are files that are stored in the hooks
subdirectory of your scaffold. They allow you to run scripts at specific points during project generation. They are skipped when the scaffold output directory is an in-memory filesystem or when they are explicitely disabled. The shebang is mandatory and can be set to any interpreter on your system.
Note That
- Template variables are available in the scripts.
- Currently, only the
post_scaffold
hook is implemented. - Hooks are matched by checking for a string prefix, so
post_scaffold.sh
will execute on thepost_scaffold
hook. - Only one hook file is allowed per hook. If multiple files are found, only the first is executed.
Working directory
The scripts' working directory is set to the scaffold output directory.
post_scaffold
The post_scaffold
hook is executed after the files have been rendered on the disk, but before the post
message is printed. It is typically used to fix the formatting of generated files.