64 lines
		
	
	
		
			1.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
		
		
			
		
	
	
			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>
							 | 
						||
| 
								 | 
							
								  }
							 | 
						||
| 
								 | 
							
								  */
							 | 
						||
| 
								 | 
							
								});
							 | 
						||
| 
								 | 
							
								```
							 |