jest-changed-files

What is jest-changed-files?

The jest-changed-files npm package is a utility that allows you to determine which files have changed in a git or hg (Mercurial) repository. It is often used in testing environments, particularly with Jest, to identify which tests need to be run based on the changes made to the codebase.

What are jest-changed-files's main functionalities?

Getting changed files from a Git repository

This feature allows you to get a list of files that have changed since the last commit in a Git repository. The 'lastCommit' option specifies that only changes from the last commit should be considered.

const { getChangedFilesForRoots } = require('jest-changed-files');

(async () => {
  const changedFiles = await getChangedFilesForRoots(['./'], { lastCommit: true });
  console.log(changedFiles.changedFiles);
})();

Getting changed files from a Mercurial repository

This feature is similar to the previous one but is used for Mercurial repositories. The 'withAncestor' option can be used to find changes that have occurred since the last common ancestor of the current head and the default branch.

const { getChangedFilesForRoots } = require('jest-changed-files');

(async () => {
  const changedFiles = await getChangedFilesForRoots(['./'], { withAncestor: true });
  console.log(changedFiles.changedFiles);
})();

Other packages similar to jest-changed-files

git-diff-apply

The git-diff-apply package provides functionality to apply the changes between two commits, branches, or tags. It is similar to jest-changed-files in that it deals with changes in a repository, but it focuses on applying changes rather than just listing them.

node-diff3

node-diff3 is a package for three-way file merging. It compares the differences between files, which can be related to the functionality of jest-changed-files, but it goes further by attempting to merge these differences automatically.

simple-git

simple-git is a light-weight interface for running git commands in any node.js application. It can be used to get a list of changed files, similar to jest-changed-files, but it also provides a full range of commands to manage Git repositories programmatically.

README

jest-changed-files

A module used internally by Jest to check which files have changed since you last committed in git or hg.

Install

$ 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.

options: Object literal with keys

• lastCommit: boolean
• withAncestor: boolean

findRepos(roots: <Array>): Promise<?object>

Get a set of git and hg repositories.

Parameters

roots: Array of string paths gathered from jest roots.

Usage

import {getChangedFilesForRoots} from 'jest-changed-files';

getChangedFilesForRoots(['/path/to/test'], {
  lastCommit: true,
  withAncestor: true,
}).then(files => {
  /*
  {
    repos: [],
    changedFiles: []
  }
  */
});

import {findRepos} from 'jest-changed-files';

findRepos(['/path/to/test']).then(repos => {
  /*
  {
    git: Set<Path>,
    hg: Set<Path>
  }
  */
});

Changelog

29.0.0

Features

• [expect] [BREAKING] Differentiate between MatcherContext MatcherUtils and MatcherState types (#13141)
• [jest-circus] Add support for test.failing.each (#13142)
• [jest-config] [BREAKING] Make snapshotFormat default to escapeString: false and printBasicPrototype: false (#13036)
• [jest-config] [BREAKING] Remove undocumented collectCoverageOnlyFrom option (#13156)
• [jest-environment-jsdom] [BREAKING] Upgrade to jsdom@20 (#13037, #13058)
• [@jest/globals] Add jest.Mocked, jest.MockedClass, jest.MockedFunction and jest.MockedObject utility types (#12727)
• [jest-mock] [BREAKING] Refactor Mocked* utility types. MaybeMockedDeep and MaybeMocked became Mocked and MockedShallow respectively; only deep mocked variants of MockedClass, MockedFunction and MockedObject are exported (#13123, #13124)
• [jest-mock] [BREAKING] Change the default jest.mocked helper’s behavior to deep mocked (#13125)
• [jest-snapshot] [BREAKING] Let babel find config when updating inline snapshots (#13150)
• [@jest/test-result, @jest/types] [BREAKING] Replace Bytes and Milliseconds types with number (#13155)
• [jest-worker] Adds workerIdleMemoryLimit option which is used as a check for worker memory leaks >= Node 16.11.0 and recycles child workers as required (#13056, #13105, #13106, #13107)
• [pretty-format] [BREAKING] Remove ConvertAnsi plugin in favour of jest-serializer-ansi-escapes (#13040)
• [pretty-format] Allow to opt out from sorting object keys with compareKeys: null (#12443)

Fixes

• [jest-config] Fix testing multiple projects with TypeScript config files (#13099)
• [@jest/expect-utils] Fix deep equality of ImmutableJS Record (#13055)
• [jest-haste-map] Increase the maximum possible file size that jest-haste-map can handle (#13094)
• [jest-runtime] Properly support CJS re-exports from dual packages (#13170)
• [jest-snapshot] Make prettierPath optional in SnapshotState (#13149)
• [jest-snapshot] Fix parsing error from inline snapshot files with JSX (#12760)
• [jest-worker] When a process runs out of memory worker exits correctly and doesn't spin indefinitely (#13054)

Chore & Maintenance

• [*] [BREAKING] Drop support for Node v12 and v17 (#13033)
• [docs] Fix webpack name (#13049)
• [docs] Explicit how to set n for --bail (#13128)
• [docs] Update Enzyme URL (#13166)
• [jest-leak-detector] Remove support for weak-napi (#13035)
• [jest-snapshot] [BREAKING] Require rootDir as argument to SnapshotState (#13150)