140 lines
4.5 KiB
JavaScript
140 lines
4.5 KiB
JavaScript
/**
|
|
* @fileoverview Defines a storage for rules.
|
|
* @author Nicholas C. Zakas
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Requirements
|
|
//------------------------------------------------------------------------------
|
|
|
|
const lodash = require("lodash");
|
|
const loadRules = require("./load-rules");
|
|
const ruleReplacements = require("../conf/replacements").rules;
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Helpers
|
|
//------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Creates a stub rule that gets used when a rule with a given ID is not found.
|
|
* @param {string} ruleId The ID of the missing rule
|
|
* @returns {{create: function(RuleContext): Object}} A rule that reports an error at the first location
|
|
* in the program. The report has the message `Definition for rule '${ruleId}' was not found` if the rule is unknown,
|
|
* or `Rule '${ruleId}' was removed and replaced by: ${replacements.join(", ")}` if the rule is known to have been
|
|
* replaced.
|
|
*/
|
|
const createMissingRule = lodash.memoize(ruleId => {
|
|
const message = Object.prototype.hasOwnProperty.call(ruleReplacements, ruleId)
|
|
? `Rule '${ruleId}' was removed and replaced by: ${ruleReplacements[ruleId].join(", ")}`
|
|
: `Definition for rule '${ruleId}' was not found`;
|
|
|
|
return {
|
|
create: context => ({
|
|
Program() {
|
|
context.report({
|
|
loc: { line: 1, column: 0 },
|
|
message
|
|
});
|
|
}
|
|
})
|
|
};
|
|
});
|
|
|
|
/**
|
|
* Normalizes a rule module to the new-style API
|
|
* @param {(Function|{create: Function})} rule A rule object, which can either be a function
|
|
* ("old-style") or an object with a `create` method ("new-style")
|
|
* @returns {{create: Function}} A new-style rule.
|
|
*/
|
|
function normalizeRule(rule) {
|
|
return typeof rule === "function" ? Object.assign({ create: rule }, rule) : rule;
|
|
}
|
|
|
|
//------------------------------------------------------------------------------
|
|
// Public Interface
|
|
//------------------------------------------------------------------------------
|
|
|
|
class Rules {
|
|
constructor() {
|
|
this._rules = Object.create(null);
|
|
|
|
this.load();
|
|
}
|
|
|
|
/**
|
|
* Registers a rule module for rule id in storage.
|
|
* @param {string} ruleId Rule id (file name).
|
|
* @param {Function} ruleModule Rule handler.
|
|
* @returns {void}
|
|
*/
|
|
define(ruleId, ruleModule) {
|
|
this._rules[ruleId] = normalizeRule(ruleModule);
|
|
}
|
|
|
|
/**
|
|
* Loads and registers all rules from passed rules directory.
|
|
* @param {string} [rulesDir] Path to rules directory, may be relative. Defaults to `lib/rules`.
|
|
* @param {string} cwd Current working directory
|
|
* @returns {void}
|
|
*/
|
|
load(rulesDir, cwd) {
|
|
const newRules = loadRules(rulesDir, cwd);
|
|
|
|
Object.keys(newRules).forEach(ruleId => {
|
|
this.define(ruleId, newRules[ruleId]);
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Registers all given rules of a plugin.
|
|
* @param {Object} plugin The plugin object to import.
|
|
* @param {string} pluginName The name of the plugin without prefix (`eslint-plugin-`).
|
|
* @returns {void}
|
|
*/
|
|
importPlugin(plugin, pluginName) {
|
|
if (plugin.rules) {
|
|
Object.keys(plugin.rules).forEach(ruleId => {
|
|
const qualifiedRuleId = `${pluginName}/${ruleId}`,
|
|
rule = plugin.rules[ruleId];
|
|
|
|
this.define(qualifiedRuleId, rule);
|
|
});
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Access rule handler by id (file name).
|
|
* @param {string} ruleId Rule id (file name).
|
|
* @returns {{create: Function, schema: JsonSchema[]}}
|
|
* A rule. This is normalized to always have the new-style shape with a `create` method.
|
|
*/
|
|
get(ruleId) {
|
|
if (!Object.prototype.hasOwnProperty.call(this._rules, ruleId)) {
|
|
return createMissingRule(ruleId);
|
|
}
|
|
if (typeof this._rules[ruleId] === "string") {
|
|
return normalizeRule(require(this._rules[ruleId]));
|
|
}
|
|
return this._rules[ruleId];
|
|
|
|
}
|
|
|
|
/**
|
|
* Get an object with all currently loaded rules
|
|
* @returns {Map} All loaded rules
|
|
*/
|
|
getAllLoadedRules() {
|
|
const allRules = new Map();
|
|
|
|
Object.keys(this._rules).forEach(name => {
|
|
const rule = this.get(name);
|
|
|
|
allRules.set(name, rule);
|
|
});
|
|
return allRules;
|
|
}
|
|
}
|
|
|
|
module.exports = Rules;
|