cli.js 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207
  1. #!/usr/bin/env node
  2. "use strict";
  3. const fs = require("fs");
  4. const path = require("path");
  5. const getStdin = require("get-stdin");
  6. const validators = require("./validators");
  7. const SPECIAL_RULES_URL =
  8. "https://github.com/prettier/eslint-config-prettier#special-rules";
  9. if (module === require.main) {
  10. if (process.argv.length > 2 || process.stdin.isTTY) {
  11. console.error(
  12. [
  13. "This tool checks whether an ESLint configuration contains rules that are",
  14. "unnecessary or conflict with Prettier. It’s supposed to be run like this:",
  15. "",
  16. " npx eslint --print-config path/to/main.js | npx eslint-config-prettier-check",
  17. " npx eslint --print-config test/index.js | npx eslint-config-prettier-check",
  18. "",
  19. "Exit codes:",
  20. "",
  21. "0: No automatically detectable problems found.",
  22. "1: Unexpected error.",
  23. "2: Conflicting rules found.",
  24. "",
  25. "For more information, see:",
  26. "https://github.com/prettier/eslint-config-prettier#cli-helper-tool",
  27. ].join("\n")
  28. );
  29. process.exit(1);
  30. }
  31. getStdin()
  32. .then((string) => {
  33. const result = processString(string);
  34. if (result.stderr) {
  35. console.error(result.stderr);
  36. }
  37. if (result.stdout) {
  38. console.error(result.stdout);
  39. }
  40. process.exit(result.code);
  41. })
  42. .catch((error) => {
  43. console.error("Unexpected error", error);
  44. process.exit(1);
  45. });
  46. }
  47. function processString(string) {
  48. let config;
  49. try {
  50. config = JSON.parse(string);
  51. } catch (error) {
  52. return {
  53. stderr: `Failed to parse JSON:\n${error.message}`,
  54. code: 1,
  55. };
  56. }
  57. if (
  58. !(
  59. Object.prototype.toString.call(config) === "[object Object]" &&
  60. Object.prototype.toString.call(config.rules) === "[object Object]"
  61. )
  62. ) {
  63. return {
  64. stderr: `Expected a \`{"rules: {...}"}\` JSON object, but got:\n${string}`,
  65. code: 1,
  66. };
  67. }
  68. // This used to look at "files" in package.json, but that is not reliable due
  69. // to an npm bug. See:
  70. // https://github.com/prettier/eslint-config-prettier/issues/57
  71. const allRules = Object.assign(
  72. Object.create(null),
  73. ...fs
  74. .readdirSync(path.join(__dirname, ".."))
  75. .filter((name) => !name.startsWith(".") && name.endsWith(".js"))
  76. .map((ruleFileName) => require(`../${ruleFileName}`).rules)
  77. );
  78. const regularRules = filterRules(
  79. allRules,
  80. (ruleName, value) => value === "off"
  81. );
  82. const optionsRules = filterRules(
  83. allRules,
  84. (ruleName, value) => value === 0 && ruleName in validators
  85. );
  86. const specialRules = filterRules(
  87. allRules,
  88. (ruleName, value) => value === 0 && !(ruleName in validators)
  89. );
  90. const flaggedRules = Object.keys(config.rules)
  91. .map((ruleName) => {
  92. const value = config.rules[ruleName];
  93. const arrayValue = Array.isArray(value) ? value : [value];
  94. const level = arrayValue[0];
  95. const options = arrayValue.slice(1);
  96. const isOff = level === "off" || level === 0;
  97. return !isOff && ruleName in allRules ? { ruleName, options } : null;
  98. })
  99. .filter(Boolean);
  100. const regularFlaggedRuleNames = filterRuleNames(
  101. flaggedRules,
  102. (ruleName) => ruleName in regularRules
  103. );
  104. const optionsFlaggedRuleNames = filterRuleNames(
  105. flaggedRules,
  106. (ruleName, options) =>
  107. ruleName in optionsRules && !validators[ruleName](options)
  108. );
  109. const specialFlaggedRuleNames = filterRuleNames(
  110. flaggedRules,
  111. (ruleName) => ruleName in specialRules
  112. );
  113. if (
  114. regularFlaggedRuleNames.length === 0 &&
  115. optionsFlaggedRuleNames.length === 0
  116. ) {
  117. const baseMessage =
  118. "No rules that are unnecessary or conflict with Prettier were found.";
  119. const message =
  120. specialFlaggedRuleNames.length === 0
  121. ? baseMessage
  122. : [
  123. baseMessage,
  124. "",
  125. "However, the following rules are enabled but cannot be automatically checked. See:",
  126. SPECIAL_RULES_URL,
  127. "",
  128. printRuleNames(specialFlaggedRuleNames),
  129. ].join("\n");
  130. return {
  131. stdout: message,
  132. code: 0,
  133. };
  134. }
  135. const regularMessage = [
  136. "The following rules are unnecessary or might conflict with Prettier:",
  137. "",
  138. printRuleNames(regularFlaggedRuleNames),
  139. ].join("\n");
  140. const optionsMessage = [
  141. "The following rules are enabled with options that might conflict with Prettier. See:",
  142. SPECIAL_RULES_URL,
  143. "",
  144. printRuleNames(optionsFlaggedRuleNames),
  145. ].join("\n");
  146. const specialMessage = [
  147. "The following rules are enabled but cannot be automatically checked. See:",
  148. SPECIAL_RULES_URL,
  149. "",
  150. printRuleNames(specialFlaggedRuleNames),
  151. ].join("\n");
  152. const message = [
  153. regularFlaggedRuleNames.length === 0 ? null : regularMessage,
  154. optionsFlaggedRuleNames.length === 0 ? null : optionsMessage,
  155. specialFlaggedRuleNames.length === 0 ? null : specialMessage,
  156. ]
  157. .filter(Boolean)
  158. .join("\n\n");
  159. return {
  160. stdout: message,
  161. code: 2,
  162. };
  163. }
  164. function filterRules(rules, fn) {
  165. return Object.keys(rules)
  166. .filter((ruleName) => fn(ruleName, rules[ruleName]))
  167. .reduce((obj, ruleName) => {
  168. obj[ruleName] = true;
  169. return obj;
  170. }, Object.create(null));
  171. }
  172. function filterRuleNames(rules, fn) {
  173. return rules
  174. .filter((rule) => fn(rule.ruleName, rule.options))
  175. .map((rule) => rule.ruleName);
  176. }
  177. function printRuleNames(ruleNames) {
  178. return ruleNames
  179. .slice()
  180. .sort()
  181. .map((ruleName) => `- ${ruleName}`)
  182. .join("\n");
  183. }
  184. exports.processString = processString;