Blame view

node_modules/eslint-plugin-node/lib/rules/no-unpublished-bin.js 3.51 KB
ce4c83ff   wxy   初始提交
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
  /**
   * @author Toru Nagashima
   * @copyright 2016 Toru Nagashima. All rights reserved.
   * See LICENSE file in root directory for full license.
   */
  "use strict"
  
  //------------------------------------------------------------------------------
  // Requirements
  //------------------------------------------------------------------------------
  
  const path = require("path")
  const getConvertPath = require("../util/get-convert-path")
  const getDocsUrl = require("../util/get-docs-url")
  const getNpmignore = require("../util/get-npmignore")
  const getPackageJson = require("../util/get-package-json")
  
  //------------------------------------------------------------------------------
  // Helpers
  //------------------------------------------------------------------------------
  
  /**
   * Checks whether or not a given path is a `bin` file.
   *
   * @param {string} filePath - A file path to check.
   * @param {string|object|undefined} binField - A value of the `bin` field of `package.json`.
   * @param {string} basedir - A directory path that `package.json` exists.
   * @returns {boolean} `true` if the file is a `bin` file.
   */
  function isBinFile(filePath, binField, basedir) {
      if (!binField) {
          return false
      }
      if (typeof binField === "string") {
          return filePath === path.resolve(basedir, binField)
      }
      return Object.keys(binField).some(key => filePath === path.resolve(basedir, binField[key]))
  }
  
  /**
   * The definition of this rule.
   *
   * @param {RuleContext} context - The rule context to check.
   * @returns {object} The definition of this rule.
   */
  function create(context) {
      return {
          Program(node) {
              // Check file path.
              let rawFilePath = context.getFilename()
              if (rawFilePath === "<input>") {
                  return
              }
              rawFilePath = path.resolve(rawFilePath)
  
              // Find package.json
              const p = getPackageJson(rawFilePath)
              if (!p) {
                  return
              }
  
              // Convert by convertPath option
              const basedir = path.dirname(p.filePath)
              const relativePath = getConvertPath(context)(
                  path.relative(basedir, rawFilePath).replace(/\\/g, "/")
              )
              const filePath = path.join(basedir, relativePath)
  
              // Check this file is bin.
              if (!isBinFile(filePath, p.bin, basedir)) {
                  return
              }
  
              // Check ignored or not
              const npmignore = getNpmignore(filePath)
              if (!npmignore.match(relativePath)) {
                  return
              }
  
              // Report.
              context.report({
                  node,
                  message:
                      "npm ignores '{{name}}'. " +
                      "Check 'files' field of 'package.json' or '.npmignore'.",
                  data: { name: relativePath },
              })
          },
      }
  }
  
  //------------------------------------------------------------------------------
  // Rule Definition
  //------------------------------------------------------------------------------
  
  module.exports = {
      create,
      meta: {
          docs: {
              description: "disallow 'bin' files which are ignored by npm",
              category: "Possible Errors",
              recommended: true,
              url: getDocsUrl("no-unpublished-bin.md"),
          },
          fixable: false,
          schema: [
              {
                  type: "object",
                  properties: { //
                      convertPath: getConvertPath.schema,
                  },
              },
          ],
      },
  }