Nearest Phase Modulator

    eslint-plugin-rulesdir

    0.2.1 • Public • Published

    eslint-plugin-rulesdir

    Allows a local directory containing ESLint rules directory to be easily used. This is a substitute for the --rulesdir option that can be used without a command-line flag.

    Experimental: This plugin is currently a proof-of-concept. Its API is likely to change in the future.

    Installation

    You'll first need to install ESLint:

    $ npm i eslint --save-dev
    

    Next, install eslint-plugin-rulesdir:

    $ npm install eslint-plugin-rulesdir --save-dev
    

    Note: If you installed ESLint globally (using the -g flag) then you must also install eslint-plugin-rulesdir globally.

    Usage

    To use this plugin, you must load it manually first and set its RULES_DIR property to a path, or an array of paths. The paths are resolved from the current working directory, and indicates where you would like the plugin to load your rules from. This is easiest if you use a JavaScript config file (.eslintrc.js), and use a local installation of ESLint.

    // .eslintrc.js
    const rulesDirPlugin = require('eslint-plugin-rulesdir');
    rulesDirPlugin.RULES_DIR = 'tools/eslint-rules'; // (an example folder where your rules might be stored)
    
    // You can also provide an array if you have multiple folders with rules in:
    rulesDirPlugin.RULES_DIR = ['tools/eslint-rules', 'tools/other-eslint-rules'];

    Then you should add rulesdir to the plugins section of your .eslintrc.js file.

    {
      plugins: [
        'rulesdir'
      ]
    }

    Finally, you can configure your local rules, prefixed with rulesdir/.

    {
      rules: {
        //
        'rulesdir/my-internal-foo-rule': 'error',
        'rulesdir/my-internal-bar-rule': ['warn', 2]
      }
    }

    All of the rules from your configured rules directory will be available. In this example, we assumed there were rule files in tools/eslint-rules/my-internal-foo-rule.js and tools/eslint-rules/my-internal-bar-rule.js.

    Prior Art

    License

    MIT

    Install

    npm i eslint-plugin-rulesdir

    DownloadsWeekly Downloads

    60,371

    Version

    0.2.1

    License

    MIT

    Unpacked Size

    7.84 kB

    Total Files

    9

    Last publish

    Collaborators

    • not-an-aardvark