Sovra

Rust-based Test Decider for JavaScript using Oxc

Speed up your monorepo pipeline by only running the tests affected by your code diff.

Features

• TypeScript support, including path aliases
• Configurable resolver, with support for extensions, export conditions and more
• High performance because it is written in Rust using Oxc
• Easy to use with Node API

Installation

yarn add sovra

Usage

getAffected(testFiles: string[], changedFiles: string[], resolverOptions: OxcResolverOptions)

Returns a subset of testFiles that have changedFiles in their import graph. This is useful in order to determine which tests to run in a large repo.

Arguments

| Name | Description | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | testFiles | List of files to check if they were affected by changes | | changedFiles | List of changed files | | resolverOptions | Configuration on how to resolve imports, see oxc-resolver |

Example

import { getAffected } from "sovra";
import { execSync } from "node:child_process";
import { glob } from "glob";

const testFiles = glob.sync("src/**/*.spec.{ts,tsx}");
const changedFiles = execSync("git diff --name-only main", { encoding: "utf8" })
  .trim()
  .split("\n");
const resolverOptions = {
  tsconfig: {
    configFile: "tsconfig.json",
  },
};

const affected = getAffected(testFiles, changedFiles, resolverOptions);

if (affected.errors) {
  console.error(...affected.errors);
} else {
  console.log(affected.files);
}

Test

cargo test

Limitations

Imports using variables or expressions are not supported as they can only be determined during runtime:

require(process.env.SOME_VAR + ".js"); // ❌
import(`./file.${platform}.mjs`); // ❌

License

MIT © Joel Arvidsson 2024