From 78f761b85d2fbd716790f85e097ce7b0c3cbe7d1 Mon Sep 17 00:00:00 2001
From: yosuke ota <otameshiyo23@gmail.com>
Date: Sat, 2 Oct 2021 17:57:47 +0900
Subject: [PATCH] Chore: add generate new rule command

---
 docs/developer-guide/README.md |   5 +-
 package.json                   |   1 +
 tools/new-rule.js              | 160 +++++++++++++++++++++++++++++++++
 3 files changed, 164 insertions(+), 2 deletions(-)
 create mode 100644 tools/new-rule.js

diff --git a/docs/developer-guide/README.md b/docs/developer-guide/README.md
index f08ecc3a8..c5bfcc99e 100644
--- a/docs/developer-guide/README.md
+++ b/docs/developer-guide/README.md
@@ -13,8 +13,7 @@ Please include as much detail as possible to help us properly address your issue
 In order to add a new rule or a rule change, you should:
 
 - Create issue on GitHub with description of proposed rule
-- Generate a new rule using the [official yeoman generator](https://github.com/eslint/generator-eslint)
-- Run `npm start`
+- Generate a new rule using the `npm run new -- [rule-name]` command
 - Write test scenarios & implement logic
 - Describe the rule in the generated `docs` file
 - Make sure all tests are passing
@@ -38,10 +37,12 @@ After opening [astexplorer.net], select `Vue` as the syntax and `vue-eslint-pars
 Since single file components in Vue are not plain JavaScript, we can't use the default parser, and we had to introduce additional one: `vue-eslint-parser`, that generates enhanced AST with nodes that represent specific parts of the template syntax, as well as what's inside the `<script>` tag.
 
 To know more about certain nodes in produced ASTs, go here:
+
 - [ESTree docs](https://github.com/estree/estree)
 - [vue-eslint-parser AST docs](https://github.com/vuejs/vue-eslint-parser/blob/master/docs/ast.md)
 
 The `vue-eslint-parser` provides few useful parser services, to help traverse the produced AST and access tokens of the template:
+
 - `context.parserServices.defineTemplateBodyVisitor(visitor, scriptVisitor)`
 - `context.parserServices.getTemplateBodyTokenStore()`
 
diff --git a/package.json b/package.json
index 8e8220581..fc5b22a13 100644
--- a/package.json
+++ b/package.json
@@ -4,6 +4,7 @@
   "description": "Official ESLint plugin for Vue.js",
   "main": "lib/index.js",
   "scripts": {
+    "new": "node tools/new-rule.js",
     "start": "npm run test:base -- --watch --growl",
     "test:base": "mocha \"tests/lib/**/*.js\" --reporter dot",
     "test": "nyc npm run test:base -- \"tests/integrations/*.js\" --timeout 60000",
diff --git a/tools/new-rule.js b/tools/new-rule.js
new file mode 100644
index 000000000..68a8b440c
--- /dev/null
+++ b/tools/new-rule.js
@@ -0,0 +1,160 @@
+const path = require('path')
+const fs = require('fs')
+const cp = require('child_process')
+const logger = console
+
+// main
+;((ruleId) => {
+  if (ruleId == null) {
+    logger.error('Usage: npm run new <RuleID>')
+    process.exitCode = 1
+    return
+  }
+  if (!/^[\w-]+$/u.test(ruleId)) {
+    logger.error("Invalid RuleID '%s'.", ruleId)
+    process.exitCode = 1
+    return
+  }
+
+  const ruleFile = path.resolve(__dirname, `../lib/rules/${ruleId}.js`)
+  const testFile = path.resolve(__dirname, `../tests/lib/rules/${ruleId}.js`)
+  const docFile = path.resolve(__dirname, `../docs/rules/${ruleId}.md`)
+
+  fs.writeFileSync(
+    ruleFile,
+    `/**
+ * @author *****your name*****
+ * See LICENSE file in root directory for full license.
+ */
+'use strict'
+
+// ------------------------------------------------------------------------------
+// Requirements
+// ------------------------------------------------------------------------------
+
+// ...
+
+// ------------------------------------------------------------------------------
+// Helpers
+// ------------------------------------------------------------------------------
+
+// ...
+
+// ------------------------------------------------------------------------------
+// Rule Definition
+// ------------------------------------------------------------------------------
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '',
+      categories: undefined,
+      url: ''
+    },
+    fixable: null,
+    schema: [],
+    messages: {
+      // ...
+    }
+  },
+  /** @param {RuleContext} context */
+  create(context) {
+    // ...
+
+    return utils.defineTemplateBodyVisitor(context, {
+      // ...
+    })
+  }
+}
+`
+  )
+  fs.writeFileSync(
+    testFile,
+    `/**
+ * @author *****your name*****
+ * See LICENSE file in root directory for full license.
+ */
+'use strict'
+
+const RuleTester = require('eslint').RuleTester
+const rule = require('../../../lib/rules/${ruleId}')
+
+const tester = new RuleTester({
+  parser: require.resolve('vue-eslint-parser'),
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module'
+  }
+})
+
+tester.run('${ruleId}', rule, {
+  valid: [
+    {
+      filename: 'test.vue',
+      code: \`
+      <template>
+
+      </template>
+      \`
+    },
+  ],
+  invalid: [
+    {
+      filename: 'test.vue',
+      code: \`
+      <template>
+
+      </template>
+      \`,
+      errors: [
+        {
+          message: '...',
+          line: 'line',
+          column: 'col'
+        },
+      ]
+    }
+  ]
+})
+`
+  )
+  fs.writeFileSync(
+    docFile,
+    `---
+pageClass: rule-details
+sidebarDepth: 0
+title: vue/${ruleId}
+description: xxx
+---
+# vue/${ruleId}
+
+> xxx
+
+- :exclamation: <badge text="This rule has not been released yet." vertical="middle" type="error"> ***This rule has not been released yet.*** </badge>
+
+## :book: Rule Details
+
+This rule ....
+
+<eslint-code-block :rules="{'vue/${ruleId}': ['error']}">
+
+\`\`\`vue
+<template>
+
+</template>
+\`\`\`
+
+</eslint-code-block>
+
+## :wrench: Options
+
+Nothing.
+
+`
+  )
+
+  cp.execSync(`code "${ruleFile}"`)
+  cp.execSync(`code "${testFile}"`)
+  cp.execSync(`code "${docFile}"`)
+})(process.argv[2])