Skip to content

Commit

Permalink
feat: move InitialOptions to JSON schema (#14776)
Browse files Browse the repository at this point in the history
  • Loading branch information
@SimenB
SimenB committed Dec 27, 2023
1 parent 1d30b3e commit 896573b
Show file tree
Hide file tree
Showing 3 changed files with 364 additions and 139 deletions.
34 changes: 7 additions & 27 deletions packages/jest-schemas/src/index.ts
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,33 +6,13 @@
*/

import {type Static, Type} from '@sinclair/typebox';

const RawSnapshotFormat = Type.Partial(
Type.Object({
callToJSON: Type.Readonly(Type.Boolean()),
compareKeys: Type.Readonly(Type.Null()),
escapeRegex: Type.Readonly(Type.Boolean()),
escapeString: Type.Readonly(Type.Boolean()),
highlight: Type.Readonly(Type.Boolean()),
indent: Type.Readonly(Type.Number({minimum: 0})),
maxDepth: Type.Readonly(Type.Number({minimum: 0})),
maxWidth: Type.Readonly(Type.Number({minimum: 0})),
min: Type.Readonly(Type.Boolean()),
printBasicPrototype: Type.Readonly(Type.Boolean()),
printFunctionName: Type.Readonly(Type.Boolean()),
theme: Type.Readonly(
Type.Partial(
Type.Object({
comment: Type.Readonly(Type.String()),
content: Type.Readonly(Type.String()),
prop: Type.Readonly(Type.String()),
tag: Type.Readonly(Type.String()),
value: Type.Readonly(Type.String()),
}),
),
),
}),
);
import {RawFakeTimers, RawInitialOptions, RawSnapshotFormat} from './raw-types';

export const SnapshotFormat = Type.Strict(RawSnapshotFormat);
export type SnapshotFormat = Static<typeof RawSnapshotFormat>;

export const InitialOptions = Type.Strict(RawInitialOptions);
export type InitialOptions = Static<typeof RawInitialOptions>;

export const FakeTimers = Type.Strict(RawFakeTimers);
export type FakeTimers = Static<typeof RawFakeTimers>;
354 changes: 354 additions & 0 deletions packages/jest-schemas/src/raw-types.ts
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,354 @@
/**
* Copyright (c) Meta Platforms, Inc. and affiliates.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*/

/* eslint-disable sort-keys */

import {type Static, Type} from '@sinclair/typebox';

export const RawSnapshotFormat = Type.Partial(
Type.Object({
callToJSON: Type.Boolean(),
compareKeys: Type.Null(),
escapeRegex: Type.Boolean(),
escapeString: Type.Boolean(),
highlight: Type.Boolean(),
indent: Type.Integer({minimum: 0}),
maxDepth: Type.Integer({minimum: 0}),
maxWidth: Type.Integer({minimum: 0}),
min: Type.Boolean(),
printBasicPrototype: Type.Boolean(),
printFunctionName: Type.Boolean(),
theme: Type.Partial(
Type.Object({
comment: Type.String(),
content: Type.String(),
prop: Type.String(),
tag: Type.String(),
value: Type.String(),
}),
),
}),
);

const RawCoverageProvider = Type.Union([
Type.Literal('babel'),
Type.Literal('v8'),
]);

const RawCoverageThresholdValue = Type.Partial(
Type.Object({
branches: Type.Number({minimum: 0, maximum: 100}),
functions: Type.Number({minimum: 0, maximum: 100}),
lines: Type.Number({minimum: 0, maximum: 100}),
statements: Type.Number({minimum: 0, maximum: 100}),
}),
);

const RawCoverageThresholdBase = Type.Object(
{global: RawCoverageThresholdValue},
{additionalProperties: RawCoverageThresholdValue},
);

const RawCoverageThreshold = Type.Unsafe<{
global: Static<typeof RawCoverageThresholdValue>;
[path: string]: Static<typeof RawCoverageThresholdValue>;
}>(RawCoverageThresholdBase);

// TODO: add type test that these are all the colors available in chalk.ForegroundColor
export const ChalkForegroundColors = Type.Union([
Type.Literal('black'),
Type.Literal('red'),
Type.Literal('green'),
Type.Literal('yellow'),
Type.Literal('blue'),
Type.Literal('magenta'),
Type.Literal('cyan'),
Type.Literal('white'),
Type.Literal('gray'),
Type.Literal('grey'),
Type.Literal('blackBright'),
Type.Literal('redBright'),
Type.Literal('greenBright'),
Type.Literal('yellowBright'),
Type.Literal('blueBright'),
Type.Literal('magentaBright'),
Type.Literal('cyanBright'),
Type.Literal('whiteBright'),
]);

const RawDisplayName = Type.Object({
name: Type.String(),
color: ChalkForegroundColors,
});

// TODO: verify these are the names of istanbulReport.ReportOptions
export const RawCoverageReporterNames = Type.Union([
Type.Literal('clover'),
Type.Literal('cobertura'),
Type.Literal('html-spa'),
Type.Literal('html'),
Type.Literal('json'),
Type.Literal('json-summary'),
Type.Literal('lcov'),
Type.Literal('lcovonly'),
Type.Literal('none'),
Type.Literal('teamcity'),
Type.Literal('text'),
Type.Literal('text-lcov'),
Type.Literal('text-summary'),
]);

const RawCoverageReporters = Type.Array(
Type.Union([
RawCoverageReporterNames,
Type.Tuple([
RawCoverageReporterNames,
Type.Record(Type.String(), Type.Unknown()),
]),
]),
);

const RawGlobalFakeTimersConfig = Type.Partial(
Type.Object({
enableGlobally: Type.Boolean({
description:
'Whether fake timers should be enabled globally for all test files.',
default: false,
}),
}),
);

const RawFakeableAPI = Type.Union([
Type.Literal('Date'),
Type.Literal('hrtime'),
Type.Literal('nextTick'),
Type.Literal('performance'),
Type.Literal('queueMicrotask'),
Type.Literal('requestAnimationFrame'),
Type.Literal('cancelAnimationFrame'),
Type.Literal('requestIdleCallback'),
Type.Literal('cancelIdleCallback'),
Type.Literal('setImmediate'),
Type.Literal('clearImmediate'),
Type.Literal('setInterval'),
Type.Literal('clearInterval'),
Type.Literal('setTimeout'),
Type.Literal('clearTimeout'),
]);

const RawFakeTimersConfig = Type.Partial(
Type.Object({
advanceTimers: Type.Union([Type.Boolean(), Type.Number({minimum: 0})], {
description:
'If set to `true` all timers will be advanced automatically by 20 milliseconds every 20 milliseconds. A custom ' +
'time delta may be provided by passing a number.',
default: false,
}),
doNotFake: Type.Array(RawFakeableAPI, {
description:
'List of names of APIs (e.g. `Date`, `nextTick()`, `setImmediate()`, `setTimeout()`) that should not be faked.' +
'\n\nThe default is `[]`, meaning all APIs are faked.',
default: [],
}),
now: Type.Integer({
minimum: 0,
description:
'Sets current system time to be used by fake timers.\n\nThe default is `Date.now()`.',
}),
timerLimit: Type.Number({
description:
'The maximum number of recursive timers that will be run when calling `jest.runAllTimers()`.',
default: 100_000,
minimum: 0,
}),
legacyFakeTimers: Type.Literal(false, {
description:
'Use the old fake timers implementation instead of one backed by `@sinonjs/fake-timers`.',
default: false,
}),
}),
);

const RawLegacyFakeTimersConfig = Type.Partial(
Type.Object({
legacyFakeTimers: Type.Literal(true, {
description:
'Use the old fake timers implementation instead of one backed by `@sinonjs/fake-timers`.',
default: true,
}),
}),
);

export const RawFakeTimers = Type.Intersect([
RawGlobalFakeTimersConfig,
Type.Union([RawFakeTimersConfig, RawLegacyFakeTimersConfig]),
]);

const RawHasteConfig = Type.Partial(
Type.Object({
computeSha1: Type.Boolean({
description: 'Whether to hash files using SHA-1.',
}),
defaultPlatform: Type.Union([Type.String(), Type.Null()], {
description: 'The platform to use as the default, e.g. `ios`.',
}),
forceNodeFilesystemAPI: Type.Boolean({
description:
"Whether to force the use of Node's `fs` API when reading files rather than shelling out to `find`.",
}),
enableSymlinks: Type.Boolean({
description:
'Whether to follow symlinks when crawling for files.' +
'\n\tThis options cannot be used in projects which use watchman.' +
'\n\tProjects with `watchman` set to true will error if this option is set to true.',
}),
hasteImplModulePath: Type.String({
description: 'Path to a custom implementation of Haste.',
}),
platforms: Type.Array(Type.String(), {
description: "All platforms to target, e.g ['ios', 'android'].",
}),
throwOnModuleCollision: Type.Boolean({
description: 'Whether to throw on error on module collision.',
}),
hasteMapModulePath: Type.String({
description: 'Custom HasteMap module',
}),
retainAllFiles: Type.Boolean({
description:
'Whether to retain all files, allowing e.g. search for tests in `node_modules`.',
}),
}),
);

export const RawInitialOptions = Type.Partial(
Type.Object({
automock: Type.Boolean(),
bail: Type.Union([Type.Boolean(), Type.Number()]),
cache: Type.Boolean(),
cacheDirectory: Type.String(),
ci: Type.Boolean(),
clearMocks: Type.Boolean(),
changedFilesWithAncestor: Type.Boolean(),
changedSince: Type.String(),
collectCoverage: Type.Boolean(),
collectCoverageFrom: Type.Array(Type.String()),
coverageDirectory: Type.String(),
coveragePathIgnorePatterns: Type.Array(Type.String()),
coverageProvider: RawCoverageProvider,
coverageReporters: RawCoverageReporters,
coverageThreshold: RawCoverageThreshold,
dependencyExtractor: Type.String(),
detectLeaks: Type.Boolean(),
detectOpenHandles: Type.Boolean(),
displayName: Type.Union([Type.String(), RawDisplayName]),
expand: Type.Boolean(),
extensionsToTreatAsEsm: Type.Array(Type.String()),
fakeTimers: RawFakeTimers,
filter: Type.String(),
findRelatedTests: Type.Boolean(),
forceCoverageMatch: Type.Array(Type.String()),
forceExit: Type.Boolean(),
json: Type.Boolean(),
globals: Type.Record(Type.String(), Type.Unknown()),
globalSetup: Type.Union([Type.String(), Type.Null()]),
globalTeardown: Type.Union([Type.String(), Type.Null()]),
haste: RawHasteConfig,
id: Type.String(),
injectGlobals: Type.Boolean(),
reporters: Type.Array(
Type.Union([
Type.String(),
Type.Tuple([Type.String(), Type.Record(Type.String(), Type.Unknown())]),
]),
),
logHeapUsage: Type.Boolean(),
lastCommit: Type.Boolean(),
listTests: Type.Boolean(),
maxConcurrency: Type.Integer(),
maxWorkers: Type.Union([Type.String(), Type.Integer()]),
moduleDirectories: Type.Array(Type.String()),
moduleFileExtensions: Type.Array(Type.String()),
moduleNameMapper: Type.Record(
Type.String(),
Type.Union([Type.String(), Type.Array(Type.String())]),
),
modulePathIgnorePatterns: Type.Array(Type.String()),
modulePaths: Type.Array(Type.String()),
noStackTrace: Type.Boolean(),
notify: Type.Boolean(),
notifyMode: Type.String(),
onlyChanged: Type.Boolean(),
onlyFailures: Type.Boolean(),
openHandlesTimeout: Type.Number(),
outputFile: Type.String(),
passWithNoTests: Type.Boolean(),
preset: Type.Union([Type.String(), Type.Null()]),
prettierPath: Type.Union([Type.String(), Type.Null()]),
projects: Type.Array(
Type.Union([
Type.String(),
// TODO: Make sure to type these correctly
Type.Record(Type.String(), Type.Unknown()),
]),
),
randomize: Type.Boolean(),
replname: Type.Union([Type.String(), Type.Null()]),
resetMocks: Type.Boolean(),
resetModules: Type.Boolean(),
resolver: Type.Union([Type.String(), Type.Null()]),
restoreMocks: Type.Boolean(),
rootDir: Type.String(),
roots: Type.Array(Type.String()),
runner: Type.String(),
runTestsByPath: Type.Boolean(),
runtime: Type.String(),
sandboxInjectedGlobals: Type.Array(Type.String()),
setupFiles: Type.Array(Type.String()),
setupFilesAfterEnv: Type.Array(Type.String()),
showSeed: Type.Boolean(),
silent: Type.Boolean(),
skipFilter: Type.Boolean(),
skipNodeResolution: Type.Boolean(),
slowTestThreshold: Type.Number(),
snapshotResolver: Type.String(),
snapshotSerializers: Type.Array(Type.String()),
snapshotFormat: RawSnapshotFormat,
errorOnDeprecated: Type.Boolean(),
testEnvironment: Type.String(),
testEnvironmentOptions: Type.Record(Type.String(), Type.Unknown()),
testFailureExitCode: Type.Union([Type.String(), Type.Integer()]),
testLocationInResults: Type.Boolean(),
testMatch: Type.Array(Type.String()),
testNamePattern: Type.String(),
testPathIgnorePatterns: Type.Array(Type.String()),
testRegex: Type.Union([Type.String(), Type.Array(Type.String())]),
testResultsProcessor: Type.String(),
testRunner: Type.String(),
testSequencer: Type.String(),
testTimeout: Type.Number(),
transform: Type.Record(
Type.String(),
Type.Union([Type.String(), Type.Tuple([Type.String(), Type.Unknown()])]),
),
transformIgnorePatterns: Type.Array(Type.String()),
watchPathIgnorePatterns: Type.Array(Type.String()),
unmockedModulePathPatterns: Type.Array(Type.String()),
updateSnapshot: Type.Boolean(),
useStderr: Type.Boolean(),
verbose: Type.Boolean(),
waitNextEventLoopTurnForUnhandledRejectionEvents: Type.Boolean(),
watch: Type.Boolean(),
watchAll: Type.Boolean(),
watchman: Type.Boolean(),
watchPlugins: Type.Array(
Type.Union([Type.String(), Type.Tuple([Type.String(), Type.Unknown()])]),
),
workerIdleMemoryLimit: Type.Union([Type.Number(), Type.String()]),
workerThreads: Type.Boolean(),
}),
);

0 comments on commit 896573b

Please sign in to comment.