Permalink
Cannot retrieve contributors at this time
227 lines (201 sloc)
7.2 KB
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
codeql-action/node_modules/eslint-plugin-prettier/eslint-plugin-prettier.js
Go to fileThis commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** | |
* @file Runs `prettier` as an ESLint rule. | |
* @author Andres Suarez | |
*/ | |
// @ts-check | |
/** | |
* @typedef {import('eslint').AST.Range} Range | |
* @typedef {import('eslint').AST.SourceLocation} SourceLocation | |
* @typedef {import('eslint').ESLint.Plugin} Plugin | |
* @typedef {import('prettier').FileInfoOptions} FileInfoOptions | |
* @typedef {import('prettier').Options & { onDiskFilepath: string, parserPath: string, usePrettierrc?: boolean }} Options | |
*/ | |
'use strict'; | |
// ------------------------------------------------------------------------------ | |
// Requirements | |
// ------------------------------------------------------------------------------ | |
const { | |
showInvisibles, | |
generateDifferences, | |
} = require('prettier-linter-helpers'); | |
// ------------------------------------------------------------------------------ | |
// Constants | |
// ------------------------------------------------------------------------------ | |
const { INSERT, DELETE, REPLACE } = generateDifferences; | |
// ------------------------------------------------------------------------------ | |
// Privates | |
// ------------------------------------------------------------------------------ | |
// Lazily-loaded Prettier. | |
/** | |
* @type {(source: string, options: Options, fileInfoOptions: FileInfoOptions) => string} | |
*/ | |
let prettierFormat; | |
// ------------------------------------------------------------------------------ | |
// Rule Definition | |
// ------------------------------------------------------------------------------ | |
/** | |
* Reports a difference. | |
* | |
* @param {import('eslint').Rule.RuleContext} context - The ESLint rule context. | |
* @param {import('prettier-linter-helpers').Difference} difference - The difference object. | |
* @returns {void} | |
*/ | |
function reportDifference(context, difference) { | |
const { operation, offset, deleteText = '', insertText = '' } = difference; | |
const range = /** @type {Range} */ ([offset, offset + deleteText.length]); | |
const [start, end] = range.map(index => | |
context.getSourceCode().getLocFromIndex(index), | |
); | |
context.report({ | |
messageId: operation, | |
data: { | |
deleteText: showInvisibles(deleteText), | |
insertText: showInvisibles(insertText), | |
}, | |
loc: { start, end }, | |
fix: fixer => fixer.replaceTextRange(range, insertText), | |
}); | |
} | |
// ------------------------------------------------------------------------------ | |
// Module Definition | |
// ------------------------------------------------------------------------------ | |
/** | |
* @type {Plugin} | |
*/ | |
const eslintPluginPrettier = { | |
configs: { | |
recommended: { | |
extends: ['prettier'], | |
plugins: ['prettier'], | |
rules: { | |
'prettier/prettier': 'error', | |
'arrow-body-style': 'off', | |
'prefer-arrow-callback': 'off', | |
}, | |
}, | |
}, | |
rules: { | |
prettier: { | |
meta: { | |
docs: { | |
url: 'https://github.com/prettier/eslint-plugin-prettier#options', | |
}, | |
type: 'layout', | |
fixable: 'code', | |
schema: [ | |
// Prettier options: | |
{ | |
type: 'object', | |
properties: {}, | |
additionalProperties: true, | |
}, | |
{ | |
type: 'object', | |
properties: { | |
usePrettierrc: { type: 'boolean' }, | |
fileInfoOptions: { | |
type: 'object', | |
properties: {}, | |
additionalProperties: true, | |
}, | |
}, | |
additionalProperties: true, | |
}, | |
], | |
messages: { | |
[INSERT]: 'Insert `{{ insertText }}`', | |
[DELETE]: 'Delete `{{ deleteText }}`', | |
[REPLACE]: 'Replace `{{ deleteText }}` with `{{ insertText }}`', | |
}, | |
}, | |
create(context) { | |
const usePrettierrc = | |
!context.options[1] || context.options[1].usePrettierrc !== false; | |
/** | |
* @type {FileInfoOptions} | |
*/ | |
const fileInfoOptions = | |
(context.options[1] && context.options[1].fileInfoOptions) || {}; | |
const sourceCode = context.getSourceCode(); | |
const filepath = context.getFilename(); | |
// Processors that extract content from a file, such as the markdown | |
// plugin extracting fenced code blocks may choose to specify virtual | |
// file paths. If this is the case then we need to resolve prettier | |
// config and file info using the on-disk path instead of the virtual | |
// path. | |
const onDiskFilepath = context.getPhysicalFilename(); | |
const source = sourceCode.text; | |
return { | |
Program() { | |
if (!prettierFormat) { | |
// Prettier is expensive to load, so only load it if needed. | |
prettierFormat = require('synckit').createSyncFn( | |
require.resolve('./worker'), | |
); | |
} | |
/** | |
* @type {{}} | |
*/ | |
const eslintPrettierOptions = context.options[0] || {}; | |
// prettier.format() may throw a SyntaxError if it cannot parse the | |
// source code it is given. Usually for JS files this isn't a | |
// problem as ESLint will report invalid syntax before trying to | |
// pass it to the prettier plugin. However this might be a problem | |
// for non-JS languages that are handled by a plugin. Notably Vue | |
// files throw an error if they contain unclosed elements, such as | |
// `<template><div></template>. In this case report an error at the | |
// point at which parsing failed. | |
/** | |
* @type {string} | |
*/ | |
let prettierSource; | |
try { | |
prettierSource = prettierFormat( | |
source, | |
{ | |
...eslintPrettierOptions, | |
filepath, | |
onDiskFilepath, | |
parserPath: context.parserPath, | |
usePrettierrc, | |
}, | |
fileInfoOptions, | |
); | |
} catch (err) { | |
if (!(err instanceof SyntaxError)) { | |
throw err; | |
} | |
let message = 'Parsing error: ' + err.message; | |
const error = | |
/** @type {SyntaxError & {codeFrame: string; loc: SourceLocation}} */ ( | |
err | |
); | |
// Prettier's message contains a codeframe style preview of the | |
// invalid code and the line/column at which the error occurred. | |
// ESLint shows those pieces of information elsewhere already so | |
// remove them from the message | |
if (error.codeFrame) { | |
message = message.replace(`\n${error.codeFrame}`, ''); | |
} | |
if (error.loc) { | |
message = message.replace(/ \(\d+:\d+\)$/, ''); | |
} | |
context.report({ message, loc: error.loc }); | |
return; | |
} | |
if (prettierSource == null) { | |
return; | |
} | |
if (source !== prettierSource) { | |
const differences = generateDifferences(source, prettierSource); | |
for (const difference of differences) { | |
reportDifference(context, difference); | |
} | |
} | |
}, | |
}; | |
}, | |
}, | |
}, | |
}; | |
module.exports = eslintPluginPrettier; |