467 lines
11 KiB
JavaScript
467 lines
11 KiB
JavaScript
'use strict';
|
|
|
|
const defaultExclude = require('./default-exclude.js');
|
|
const defaultExtension = require('./default-extension.js');
|
|
|
|
const nycCommands = {
|
|
all: [null, 'check-coverage', 'instrument', 'merge', 'report'],
|
|
testExclude: [null, 'instrument', 'report', 'check-coverage'],
|
|
instrument: [null, 'instrument'],
|
|
checkCoverage: [null, 'report', 'check-coverage'],
|
|
report: [null, 'report'],
|
|
main: [null],
|
|
instrumentOnly: ['instrument']
|
|
};
|
|
|
|
const cwd = {
|
|
description: 'working directory used when resolving paths',
|
|
type: 'string',
|
|
get default() {
|
|
return process.cwd();
|
|
},
|
|
nycCommands: nycCommands.all
|
|
};
|
|
|
|
const nycrcPath = {
|
|
description: 'specify an explicit path to find nyc configuration',
|
|
nycCommands: nycCommands.all
|
|
};
|
|
|
|
const tempDir = {
|
|
description: 'directory to output raw coverage information to',
|
|
type: 'string',
|
|
default: './.nyc_output',
|
|
nycAlias: 't',
|
|
nycHiddenAlias: 'temp-directory',
|
|
nycCommands: [null, 'check-coverage', 'merge', 'report']
|
|
};
|
|
|
|
const testExclude = {
|
|
exclude: {
|
|
description: 'a list of specific files and directories that should be excluded from coverage, glob patterns are supported',
|
|
type: 'array',
|
|
items: {
|
|
type: 'string'
|
|
},
|
|
default: defaultExclude,
|
|
nycCommands: nycCommands.testExclude,
|
|
nycAlias: 'x'
|
|
},
|
|
excludeNodeModules: {
|
|
description: 'whether or not to exclude all node_module folders (i.e. **/node_modules/**) by default',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.testExclude
|
|
},
|
|
include: {
|
|
description: 'a list of specific files that should be covered, glob patterns are supported',
|
|
type: 'array',
|
|
items: {
|
|
type: 'string'
|
|
},
|
|
default: [],
|
|
nycCommands: nycCommands.testExclude,
|
|
nycAlias: 'n'
|
|
},
|
|
extension: {
|
|
description: 'a list of extensions that nyc should handle in addition to .js',
|
|
type: 'array',
|
|
items: {
|
|
type: 'string'
|
|
},
|
|
default: defaultExtension,
|
|
nycCommands: nycCommands.testExclude,
|
|
nycAlias: 'e'
|
|
}
|
|
};
|
|
|
|
const instrumentVisitor = {
|
|
coverageVariable: {
|
|
description: 'variable to store coverage',
|
|
type: 'string',
|
|
default: '__coverage__',
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
coverageGlobalScope: {
|
|
description: 'scope to store the coverage variable',
|
|
type: 'string',
|
|
default: 'this',
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
coverageGlobalScopeFunc: {
|
|
description: 'avoid potentially replaced `Function` when finding global scope',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
ignoreClassMethods: {
|
|
description: 'class method names to ignore for coverage',
|
|
type: 'array',
|
|
items: {
|
|
type: 'string'
|
|
},
|
|
default: [],
|
|
nycCommands: nycCommands.instrument
|
|
}
|
|
};
|
|
|
|
const instrumentParseGen = {
|
|
autoWrap: {
|
|
description: 'allow `return` statements outside of functions',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
esModules: {
|
|
description: 'should files be treated as ES Modules',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
parserPlugins: {
|
|
description: 'babel parser plugins to use when parsing the source',
|
|
type: 'array',
|
|
items: {
|
|
type: 'string'
|
|
},
|
|
/* Babel parser plugins are to be enabled when the feature is stage 3 and
|
|
* implemented in a released version of node.js. */
|
|
default: [
|
|
'asyncGenerators',
|
|
'bigInt',
|
|
'classProperties',
|
|
'classPrivateProperties',
|
|
'classPrivateMethods',
|
|
'dynamicImport',
|
|
'importMeta',
|
|
'numericSeparator',
|
|
'objectRestSpread',
|
|
'optionalCatchBinding',
|
|
'topLevelAwait'
|
|
],
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
compact: {
|
|
description: 'should the output be compacted?',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
preserveComments: {
|
|
description: 'should comments be preserved in the output?',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
produceSourceMap: {
|
|
description: 'should source maps be produced?',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
}
|
|
};
|
|
|
|
const checkCoverage = {
|
|
excludeAfterRemap: {
|
|
description: 'should exclude logic be performed after the source-map remaps filenames?',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.checkCoverage
|
|
},
|
|
branches: {
|
|
description: 'what % of branches must be covered?',
|
|
type: 'number',
|
|
default: 0,
|
|
minimum: 0,
|
|
maximum: 100,
|
|
nycCommands: nycCommands.checkCoverage
|
|
},
|
|
functions: {
|
|
description: 'what % of functions must be covered?',
|
|
type: 'number',
|
|
default: 0,
|
|
minimum: 0,
|
|
maximum: 100,
|
|
nycCommands: nycCommands.checkCoverage
|
|
},
|
|
lines: {
|
|
description: 'what % of lines must be covered?',
|
|
type: 'number',
|
|
default: 90,
|
|
minimum: 0,
|
|
maximum: 100,
|
|
nycCommands: nycCommands.checkCoverage
|
|
},
|
|
statements: {
|
|
description: 'what % of statements must be covered?',
|
|
type: 'number',
|
|
default: 0,
|
|
minimum: 0,
|
|
maximum: 100,
|
|
nycCommands: nycCommands.checkCoverage
|
|
},
|
|
perFile: {
|
|
description: 'check thresholds per file',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.checkCoverage
|
|
}
|
|
};
|
|
|
|
const report = {
|
|
checkCoverage: {
|
|
description: 'check whether coverage is within thresholds provided',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.report
|
|
},
|
|
reporter: {
|
|
description: 'coverage reporter(s) to use',
|
|
type: 'array',
|
|
items: {
|
|
type: 'string'
|
|
},
|
|
default: ['text'],
|
|
nycCommands: nycCommands.report,
|
|
nycAlias: 'r'
|
|
},
|
|
reportDir: {
|
|
description: 'directory to output coverage reports in',
|
|
type: 'string',
|
|
default: 'coverage',
|
|
nycCommands: nycCommands.report
|
|
},
|
|
showProcessTree: {
|
|
description: 'display the tree of spawned processes',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.report
|
|
},
|
|
skipEmpty: {
|
|
description: 'don\'t show empty files (no lines of code) in report',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.report
|
|
},
|
|
skipFull: {
|
|
description: 'don\'t show files with 100% statement, branch, and function coverage',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.report
|
|
}
|
|
};
|
|
|
|
const nycMain = {
|
|
silent: {
|
|
description: 'don\'t output a report after tests finish running',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.main,
|
|
nycAlias: 's'
|
|
},
|
|
all: {
|
|
description: 'whether or not to instrument all files of the project (not just the ones touched by your test suite)',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.main,
|
|
nycAlias: 'a'
|
|
},
|
|
eager: {
|
|
description: 'instantiate the instrumenter at startup (see https://git.io/vMKZ9)',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.main
|
|
},
|
|
cache: {
|
|
description: 'cache instrumentation results for improved performance',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.main,
|
|
nycAlias: 'c'
|
|
},
|
|
cacheDir: {
|
|
description: 'explicitly set location for instrumentation cache',
|
|
type: 'string',
|
|
nycCommands: nycCommands.main
|
|
},
|
|
babelCache: {
|
|
description: 'cache babel transpilation results for improved performance',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.main
|
|
},
|
|
useSpawnWrap: {
|
|
description: 'use spawn-wrap instead of setting process.env.NODE_OPTIONS',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.main
|
|
},
|
|
hookRequire: {
|
|
description: 'should nyc wrap require?',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.main
|
|
},
|
|
hookRunInContext: {
|
|
description: 'should nyc wrap vm.runInContext?',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.main
|
|
},
|
|
hookRunInThisContext: {
|
|
description: 'should nyc wrap vm.runInThisContext?',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.main
|
|
},
|
|
clean: {
|
|
description: 'should the .nyc_output folder be cleaned before executing tests',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.main
|
|
}
|
|
};
|
|
|
|
const instrumentOnly = {
|
|
inPlace: {
|
|
description: 'should nyc run the instrumentation in place?',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.instrumentOnly
|
|
},
|
|
exitOnError: {
|
|
description: 'should nyc exit when an instrumentation failure occurs?',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.instrumentOnly
|
|
},
|
|
delete: {
|
|
description: 'should the output folder be deleted before instrumenting files?',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.instrumentOnly
|
|
},
|
|
completeCopy: {
|
|
description: 'should nyc copy all files from input to output as well as instrumented files?',
|
|
type: 'boolean',
|
|
default: false,
|
|
nycCommands: nycCommands.instrumentOnly
|
|
}
|
|
};
|
|
|
|
const nyc = {
|
|
description: 'nyc configuration options',
|
|
type: 'object',
|
|
properties: {
|
|
cwd,
|
|
nycrcPath,
|
|
tempDir,
|
|
|
|
/* Test Exclude */
|
|
...testExclude,
|
|
|
|
/* Instrumentation settings */
|
|
...instrumentVisitor,
|
|
|
|
/* Instrumentation parser/generator settings */
|
|
...instrumentParseGen,
|
|
sourceMap: {
|
|
description: 'should nyc detect and handle source maps?',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
require: {
|
|
description: 'a list of additional modules that nyc should attempt to require in its subprocess, e.g., @babel/register, @babel/polyfill',
|
|
type: 'array',
|
|
items: {
|
|
type: 'string'
|
|
},
|
|
default: [],
|
|
nycCommands: nycCommands.instrument,
|
|
nycAlias: 'i'
|
|
},
|
|
instrument: {
|
|
description: 'should nyc handle instrumentation?',
|
|
type: 'boolean',
|
|
default: true,
|
|
nycCommands: nycCommands.instrument
|
|
},
|
|
|
|
/* Check coverage */
|
|
...checkCoverage,
|
|
|
|
/* Report options */
|
|
...report,
|
|
|
|
/* Main command options */
|
|
...nycMain,
|
|
|
|
/* Instrument command options */
|
|
...instrumentOnly
|
|
}
|
|
};
|
|
|
|
const configs = {
|
|
nyc,
|
|
testExclude: {
|
|
description: 'test-exclude options',
|
|
type: 'object',
|
|
properties: {
|
|
cwd,
|
|
...testExclude
|
|
}
|
|
},
|
|
babelPluginIstanbul: {
|
|
description: 'babel-plugin-istanbul options',
|
|
type: 'object',
|
|
properties: {
|
|
cwd,
|
|
...testExclude,
|
|
...instrumentVisitor
|
|
}
|
|
},
|
|
instrumentVisitor: {
|
|
description: 'instrument visitor options',
|
|
type: 'object',
|
|
properties: instrumentVisitor
|
|
},
|
|
instrumenter: {
|
|
description: 'stand-alone instrumenter options',
|
|
type: 'object',
|
|
properties: {
|
|
...instrumentVisitor,
|
|
...instrumentParseGen
|
|
}
|
|
}
|
|
};
|
|
|
|
function defaultsReducer(defaults, [name, {default: value}]) {
|
|
/* Modifying arrays in defaults is safe, does not change schema. */
|
|
if (Array.isArray(value)) {
|
|
value = [...value];
|
|
}
|
|
|
|
return Object.assign(defaults, {[name]: value});
|
|
}
|
|
|
|
module.exports = {
|
|
...configs,
|
|
defaults: Object.keys(configs).reduce(
|
|
(defaults, id) => {
|
|
Object.defineProperty(defaults, id, {
|
|
enumerable: true,
|
|
get() {
|
|
/* This defers `process.cwd()` until defaults are requested. */
|
|
return Object.entries(configs[id].properties)
|
|
.filter(([, info]) => 'default' in info)
|
|
.reduce(defaultsReducer, {});
|
|
}
|
|
});
|
|
|
|
return defaults;
|
|
},
|
|
{}
|
|
)
|
|
};
|