Skip to content
Run tasks based on "Git diff" changes 🏃
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
__fixtures__
__tests__
bin
demo
flow-typed/npm
src
.babelrc
.flowconfig
.gitignore
.npmignore
.nvmrc
.travis.yml
LICENSE
README.md
package.json
yarn.lock

README.md

run-when Build Status

Run tasks based on git diff files

Usage

Having this directory tree with the following files changed:

├── app
├────── components
├      ├── index.js
├      ├── app.jsx
└── __tests__
├      ├── app.spec.jsx
└── package.json

run-when will check glob rules against it and run tasks if any changes have been made.

Javascript

import runWhen from 'run-when';

runWhen([
  {
    glob: ['app/components/index.js', 'app/__tests__/**'],
    task(paths) {
      console.log('This will be called!');
    }
  },
  {
    glob: ['!package.json'],
    task(paths) {
      return Promise.resolve('You can return a promise from your task');
    }
  },
  {
    // Optionally pass changed files
    changedFiles: () => Promise.resolve(['app/index.js', 'app/components/header.jsx']),
    glob: ['app/components/**'],
    task(paths) {
      console.log(paths === ['app/components/header.jsx']);
    }
  }
]);

CLI

$ run-when '["app/components/**", "app/utils/**"]' 'echo running tests... && yarn test'
  • First argument is a stringified JSON containing glob patterns.
  • Second argument is the task to run.

How it works

By default run-when will use git to know which files have been changed. You can change that passing an array of files to changedFiles.

Globbing pattern

The library uses multimatch for the globbing matching (sindresorhus 😻). Just a quick overview:

  • * matches any number of characters, but not /
  • ? matches a single character, but not /
  • ** matches any number of characters, including /, as long as it's the only thing in a path part
  • {} allows for a comma-separated list of "or" expressions
  • ! at the beginning of a pattern will negate the match

Various patterns and expected matches.

Api

type Files = Array<string>;
interface Rule {
  glob: Array<string>,
  task: (results: Files) => void,
  changedFiles?: () => Promise<Files>
}
type runWhen = (rules: Array<Rule>) => Promise;

Installation

$ yarn add run-when -D
You can’t perform that action at this time.