Configuration¶
The configuration file¶
Once you have the Therapist pre-commit hook installed you will need to
configure the actions that will be run before each commit. This is done with
a .therapist.yml
configuration file.
Add a file called .therapist.yml
to the root directory of your project. The
configuration file describes a set of actions like so:
actions: flake8: run: flake8 {files} include: "*.py" exclude: - "docs\*.py" - "migrations\*.py" eslint: description: ESLint run: yarn eslint {files} fix: yarn eslint --fix {files} include: - "*.js" - "*.jsx"
Action definitions¶
There are several optional parameters that you can specify for a action. They are:
run: | This is the actual command to be run. You may use the named placeholder
{files} which be replaced with a space-separated list of files that
were modified and added to the commit. |
---|---|
fix: | This is the command to be run when the --fix option is used. You may
use the named placeholder {files} which be replaced with a
space-separated list of files that were modified and added to the commit. |
description: | A short description of the command that is used to identify the command in the output. If it is longer than 68 characters, it will be truncated. If no description is provided it will default to the name of the command. |
include: | This can be a single string or list strings of UNIX filename patterns.
Files that match any of the patterns will be passed through to the
command through {files} unless they match a pattern in the exclude
parameter. |
exclude: | This can be a single string or a list of strings of UNIX filename patterns.
Files that match any of the patterns will never be passed through to the
command through {files} . |