Configuration Files
You can configure our tool using either TOML or YAML format. To do so, create a file namedzenable_config.toml
or zenable_config.yaml
in any directory of your repository.
TOML Example
YAML Example
Configuration Options
skip_filenames
List of additional filenames or glob patterns to skip. This field accepts a list (array) of patterns and works like gitignore, including support for negation patterns.A standard list of lock files will automatically be added to the beginning of your configuration.
- Exact filename matches (e.g.,
"package-lock.json"
) - Glob patterns (e.g.,
"**/*.rbi"
,"foo/**/*.pyc"
) - Negation patterns with
!
prefix (e.g.,"!keep-this.json"
)
Basic Glob Pattern Examples
Basic Glob Pattern Examples
*.log
- Skip all log files in any directory**/*.tmp
- Skip all .tmp files in any directory (recursive)src/**/*.test.js
- Skip all .test.js files under src/ directorydocs/*.md
- Skip markdown files directly in docs/ directorybuild/*
- Skip all files directly in build/ directory**/node_modules/**
- Skip all files in any node_modules directoryexample.py
- Skip files named example.py in any directory**/example.tmp
- Skip files named example.tmp in any directory (i.e. the same asexample.tmp
)/example.py
- Skip example.py only in the root directory
Negation Pattern Examples
Negation Pattern Examples
Negation patterns start with Skip all files in build/ except those in build/keep/Escaping files that literally start with !
!
and allow you to include files that would otherwise be skipped. Order matters - the last matching pattern wins.Skip all log files except important.logTo skip files that literally start with
!
(fairly rare), be sure to escape the exclamation mark appropriately:- TOML requires a double backslash
"\\!filename.txt"
- YAML uses a single backslash
\!filename.txt
Order matters with negation patterns! Patterns are evaluated in the order they appear in your list. The last matching pattern determines whether a file is skipped or included. This follows the same behavior as gitignore files.
skip_branches
List of branches to skip. You can use python regex to match the branch names. We will check all the patterns in the list, if any pattern match, the PR opened in that branch will be skipped.comments
Configuration section for controlling which comments are posted during reviews. This allows you to enable or disable specific informational comments that the reviewer generates.comments.taking_a_look
When set totrue
, posts the “Taking a look… 👀” comment at the start of a review. This comment indicates the review has started and is automatically deleted once the review is complete. Set to false
to disable this comment.
Default: true
(comment is posted)
comments.no_findings
When set totrue
, posts the “Nice work! 😎” comment when no issues are found in the PR. Set to false
to disable this comment - when disabled and there are no findings, no review comment will be posted at all.
Default: true
(comment is posted)
These settings only affect informational comments. Reviews with actual findings or suggestions will always be posted regardless of these settings.
Example: Disable all informational comments
Example: Disable all informational comments
Example: Only disable 'Taking a look' comment
Example: Only disable 'Taking a look' comment
Default Configuration
By default, all review comments are enabled:Troubleshooting
If you’re having issues with the GitHub Reviewer, try the following:-
Check that you only have one configuration file in your repository, either
zenable_config.toml
orzenable_config.yaml
. If you have multiple in different directories, the GitHub Reviewer will fail to load the configuration and will use the default configuration. - Check that the file is a valid TOML or YAML file and that the structure is correct.
- The skip_branches option uses python regex to match the branch names. Check that the regex is correct.
- If any of these solutions don’t work, you can contact our support team at support@zenable.io.