2022-11-10 11:43:16 +01:00
|
|
|
'use strict';
|
|
|
|
exports.__esModule = true;
|
2020-08-26 01:57:08 +02:00
|
|
|
|
2022-11-10 11:43:16 +01:00
|
|
|
const moduleRequire = require('./module-require').default;
|
|
|
|
const extname = require('path').extname;
|
|
|
|
const fs = require('fs');
|
2020-08-26 01:57:08 +02:00
|
|
|
|
2022-11-10 11:43:16 +01:00
|
|
|
const log = require('debug')('eslint-plugin-import:parse');
|
|
|
|
|
|
|
|
function getBabelEslintVisitorKeys(parserPath) {
|
|
|
|
if (parserPath.endsWith('index.js')) {
|
|
|
|
const hypotheticalLocation = parserPath.replace('index.js', 'visitor-keys.js');
|
|
|
|
if (fs.existsSync(hypotheticalLocation)) {
|
|
|
|
const keys = moduleRequire(hypotheticalLocation);
|
|
|
|
return keys.default || keys;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
|
|
|
|
function keysFromParser(parserPath, parserInstance, parsedResult) {
|
|
|
|
// Exposed by @typescript-eslint/parser and @babel/eslint-parser
|
|
|
|
if (parsedResult && parsedResult.visitorKeys) {
|
|
|
|
return parsedResult.visitorKeys;
|
|
|
|
}
|
|
|
|
if (/.*espree.*/.test(parserPath)) {
|
|
|
|
return parserInstance.VisitorKeys;
|
|
|
|
}
|
|
|
|
if (/.*babel-eslint.*/.test(parserPath)) {
|
|
|
|
return getBabelEslintVisitorKeys(parserPath);
|
|
|
|
}
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
|
|
|
|
// this exists to smooth over the unintentional breaking change in v2.7.
|
|
|
|
// TODO, semver-major: avoid mutating `ast` and return a plain object instead.
|
|
|
|
function makeParseReturn(ast, visitorKeys) {
|
|
|
|
if (ast) {
|
|
|
|
ast.visitorKeys = visitorKeys;
|
|
|
|
ast.ast = ast;
|
|
|
|
}
|
|
|
|
return ast;
|
|
|
|
}
|
|
|
|
|
|
|
|
function stripUnicodeBOM(text) {
|
|
|
|
return text.charCodeAt(0) === 0xFEFF ? text.slice(1) : text;
|
|
|
|
}
|
|
|
|
|
|
|
|
function transformHashbang(text) {
|
|
|
|
return text.replace(/^#!([^\r\n]+)/u, (_, captured) => `//${captured}`);
|
|
|
|
}
|
2020-08-26 01:57:08 +02:00
|
|
|
|
|
|
|
exports.default = function parse(path, content, context) {
|
|
|
|
|
2022-11-10 11:43:16 +01:00
|
|
|
if (context == null) throw new Error('need context to parse properly');
|
2020-08-26 01:57:08 +02:00
|
|
|
|
2022-11-10 11:43:16 +01:00
|
|
|
let parserOptions = context.parserOptions;
|
|
|
|
const parserPath = getParserPath(path, context);
|
2020-08-26 01:57:08 +02:00
|
|
|
|
2022-11-10 11:43:16 +01:00
|
|
|
if (!parserPath) throw new Error('parserPath is required!');
|
2020-08-26 01:57:08 +02:00
|
|
|
|
|
|
|
// hack: espree blows up with frozen options
|
2022-11-10 11:43:16 +01:00
|
|
|
parserOptions = Object.assign({}, parserOptions);
|
|
|
|
parserOptions.ecmaFeatures = Object.assign({}, parserOptions.ecmaFeatures);
|
2020-08-26 01:57:08 +02:00
|
|
|
|
|
|
|
// always include comments and tokens (for doc parsing)
|
2022-11-10 11:43:16 +01:00
|
|
|
parserOptions.comment = true;
|
|
|
|
parserOptions.attachComment = true; // keeping this for backward-compat with older parsers
|
|
|
|
parserOptions.tokens = true;
|
2020-08-26 01:57:08 +02:00
|
|
|
|
|
|
|
// attach node locations
|
2022-11-10 11:43:16 +01:00
|
|
|
parserOptions.loc = true;
|
|
|
|
parserOptions.range = true;
|
2020-08-26 01:57:08 +02:00
|
|
|
|
|
|
|
// provide the `filePath` like eslint itself does, in `parserOptions`
|
|
|
|
// https://github.com/eslint/eslint/blob/3ec436ee/lib/linter.js#L637
|
2022-11-10 11:43:16 +01:00
|
|
|
parserOptions.filePath = path;
|
|
|
|
|
2020-08-26 01:57:08 +02:00
|
|
|
// @typescript-eslint/parser will parse the entire project with typechecking if you provide
|
|
|
|
// "project" or "projects" in parserOptions. Removing these options means the parser will
|
|
|
|
// only parse one file in isolate mode, which is much, much faster.
|
2022-11-10 11:43:16 +01:00
|
|
|
// https://github.com/import-js/eslint-plugin-import/issues/1408#issuecomment-509298962
|
|
|
|
delete parserOptions.project;
|
|
|
|
delete parserOptions.projects;
|
|
|
|
|
2020-08-26 01:57:08 +02:00
|
|
|
// require the parser relative to the main module (i.e., ESLint)
|
2022-11-10 11:43:16 +01:00
|
|
|
const parser = moduleRequire(parserPath);
|
|
|
|
|
|
|
|
// replicate bom strip and hashbang transform of ESLint
|
|
|
|
// https://github.com/eslint/eslint/blob/b93af98b3c417225a027cabc964c38e779adb945/lib/linter/linter.js#L779
|
|
|
|
content = transformHashbang(stripUnicodeBOM(String(content)));
|
2020-08-26 01:57:08 +02:00
|
|
|
|
|
|
|
if (typeof parser.parseForESLint === 'function') {
|
2022-11-10 11:43:16 +01:00
|
|
|
let ast;
|
2020-08-26 01:57:08 +02:00
|
|
|
try {
|
2022-11-10 11:43:16 +01:00
|
|
|
const parserRaw = parser.parseForESLint(content, parserOptions);
|
|
|
|
ast = parserRaw.ast;
|
|
|
|
return makeParseReturn(ast, keysFromParser(parserPath, parser, parserRaw));
|
2020-08-26 01:57:08 +02:00
|
|
|
} catch (e) {
|
2022-11-10 11:43:16 +01:00
|
|
|
console.warn();
|
|
|
|
console.warn('Error while parsing ' + parserOptions.filePath);
|
|
|
|
console.warn('Line ' + e.lineNumber + ', column ' + e.column + ': ' + e.message);
|
2020-08-26 01:57:08 +02:00
|
|
|
}
|
|
|
|
if (!ast || typeof ast !== 'object') {
|
|
|
|
console.warn(
|
|
|
|
'`parseForESLint` from parser `' +
|
|
|
|
parserPath +
|
|
|
|
'` is invalid and will just be ignored'
|
2022-11-10 11:43:16 +01:00
|
|
|
);
|
2020-08-26 01:57:08 +02:00
|
|
|
} else {
|
2022-11-10 11:43:16 +01:00
|
|
|
return makeParseReturn(ast, keysFromParser(parserPath, parser, undefined));
|
2020-08-26 01:57:08 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-11-10 11:43:16 +01:00
|
|
|
const ast = parser.parse(content, parserOptions);
|
|
|
|
return makeParseReturn(ast, keysFromParser(parserPath, parser, undefined));
|
|
|
|
};
|
2020-08-26 01:57:08 +02:00
|
|
|
|
|
|
|
function getParserPath(path, context) {
|
2022-11-10 11:43:16 +01:00
|
|
|
const parsers = context.settings['import/parsers'];
|
2020-08-26 01:57:08 +02:00
|
|
|
if (parsers != null) {
|
2022-11-10 11:43:16 +01:00
|
|
|
const extension = extname(path);
|
|
|
|
for (const parserPath in parsers) {
|
2020-08-26 01:57:08 +02:00
|
|
|
if (parsers[parserPath].indexOf(extension) > -1) {
|
|
|
|
// use this alternate parser
|
2022-11-10 11:43:16 +01:00
|
|
|
log('using alt parser:', parserPath);
|
|
|
|
return parserPath;
|
2020-08-26 01:57:08 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
// default to use ESLint parser
|
2022-11-10 11:43:16 +01:00
|
|
|
return context.parserPath;
|
2020-08-26 01:57:08 +02:00
|
|
|
}
|