setup-python/node_modules/jest-changed-files/README.md
Danny McCormick 39c08a0eaa Initial pass
2019-06-26 21:12:00 -04:00

64 lines
1.2 KiB
Markdown

# jest-changed-files
A module used internally by Jest to check which files have changed since you last committed in git or hg.
## Install
```sh
$ npm install --save jest-changed-files
```
## API
### `getChangedFilesForRoots(roots: <Array<string>>, options: ?object): Promise<?object>`
Get the list of files and repos that have changed since the last commit.
#### Parameters
roots: Array of string paths gathered from [jest roots](https://jestjs.io/docs/configuration.html#roots-array-string).
options: Object literal with keys
- lastCommit: boolean
- withAncestor: boolean
### findRepos(roots: <Array<string>>): Promise<?object>
Get a set of git and hg repositories.
#### Parameters
roots: Array of string paths gathered from [jest roots](https://jestjs.io/docs/configuration.html#roots-array-string).
## Usage
```javascript
import {getChangedFilesForRoots} from 'jest-changed-files';
getChangedFilesForRoots(['/path/to/test'], {
lastCommit: true,
withAncestor: true,
}).then(files => {
/*
{
repos: [],
changedFiles: []
}
*/
});
```
```javascript
import {findRepos} from 'jest-changed-files';
findRepos(['/path/to/test']).then(repos => {
/*
{
git: Set<Path>,
hg: Set<Path>
}
*/
});
```