paths-filter

Paths Changes Filter

GitHub Action that enables conditional execution of workflow steps and jobs, based on the files modified by pull request, on a feature branch, or by the recently pushed commits.

Run slow tasks like integration tests or deployments only for changed components. It saves time and resources, especially in monorepo setups. GitHub workflows built-in path filters don't allow this because they don't work on a level of individual jobs or steps.

Real world usage examples:

• sentry.io - backend.yml
• GoogleChrome/web.dev - lint-workflow.yml
• blog post Configuring python linting to be part of CI/CD using GitHub actions - py_linter.yml

Supported workflows

• Pull requests:
  • Workflow triggered by pull_request or pull_request_target event
  • Changes are detected against the pull request base branch
  • Uses GitHub REST API to fetch a list of modified files
  • Requires pull-requests: read permission
• Feature branches:
  • Workflow triggered by push or any other event
  • The base input parameter must not be the same as the branch that triggered the workflow
  • Changes are detected against the merge-base with the configured base branch or the default branch
  • Uses git commands to detect changes - repository must be already checked out
• Merge queue: