Skip to content
Sarj Code Standards

source-coupled-test

Disallow raw repository source text as a test oracle; parse or execute the artifact instead.

rawSourceOracle Rule source Tests Catalog JSON

Why

Substring and regex checks can pass on comments or unreachable configuration and fail after behavior-preserving formatting changes.

Fix

Reuse adequate existing validation; otherwise assert a distinct parsed or runtime contract. Preserve deliberate representation contracts with an exact justified suppression.

Examples

Before — flagged Do not prove workflow behavior with a regex
src/policy.test.ts
import { readFileSync } from "node:fs";
test("policy", () => {
  const source = readFileSync("workflow.yml", "utf8");
  expect(source).toMatch(/permissions/);
});
After — preferred Assert on parsed policy behavior
src/policy.test.ts
import { readFileSync } from "node:fs";
test("policy", () => {
  const policy = JSON.parse(readFileSync("policy.json", "utf8"));
  expect(validate(policy)).toEqual([]);
});