paths

Files are matched to scopes using glob patterns.

The glob patterns are case-insensitive, and use:

  • * to match any number of characters except /
  • ** to match any number of characters including /
  • ? to match a single character
  • [...] to match a range of characters
  • [!...] to match any character not in the range
  • \ to escape special characters
  • {...,...} to match any of the comma-separated patterns
  • ! at the start to exclude paths (negate pattern)

The patterns should never start with a /, as they are always matched against the relative path of the CODEREVIEW.toml file.

Excluding Paths

You can exclude specific paths from a scope by prefixing the pattern with !:

[[scopes]]
name = "backend"
paths = ["backend/**/*", "!backend/tests/**/*", "!backend/**/*.test.py"]

This will match all files in the backend/ directory except for files in the tests/ subdirectory and files ending with .test.py.

[[scopes]]
name = "app"
paths = ["app/**/*"]

[[scopes]]
name = "docs"
paths = ["docs/**/*", "**/*.md"]

$ git diff --name-only
app/INSTRUCTIONS.md
app/package.json
docs/README.md

$ pullapprove match --diff
app/INSTRUCTIONS.md -> docs
app/package.json -> app
docs/README.md -> docs

Example with Exclusions

[[scopes]]
name = "source-code"
paths = ["src/**/*", "!src/**/*.test.js", "!src/**/__tests__/**/*"]

[[scopes]]
name = "tests"
paths = ["src/**/*.test.js", "src/**/__tests__/**/*"]

$ git diff --name-only
src/utils/helper.js
src/utils/helper.test.js
src/components/__tests__/Button.js

$ pullapprove match --diff
src/utils/helper.js -> source-code
src/utils/helper.test.js -> tests
src/components/__tests__/Button.js -> tests

Note that when files are renamed or moved, both the old and new paths will be used for scope matching.

$ git diff --name-status
R100    app/README.md    docs/README.md

$ pullapprove match --diff
app/README.md -> app
docs/README.md -> docs