ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

ESLint-Formatter

by TheSavior ST2/ST3

Sublime Text 3 Plugin to Autoformat with Eslint

Details

Installs

  • Total 35K
  • Win 13K
  • OS X 17K
  • Linux 6K
Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1 Aug 31 Aug 30 Aug 29 Aug 28 Aug 27 Aug 26 Aug 25 Aug 24 Aug 23 Aug 22 Aug 21 Aug 20 Aug 19 Aug 18 Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9 Aug 8 Aug 7 Aug 6
Windows 0 6 6 4 14 4 3 6 8 2 10 6 3 8 8 3 8 6 9 4 5 9 10 5 7 8 5 2 8 8 7 3 0 5 5 6 5 7 6 6 0 1 6 7 6 13
OS X 2 10 8 7 9 3 6 6 8 13 10 7 3 4 14 12 13 8 9 3 3 13 7 17 23 6 1 6 11 6 8 5 10 3 2 8 9 5 10 6 4 5 8 8 11 12
Linux 0 5 3 2 4 0 1 1 0 7 3 10 1 0 3 8 3 1 0 2 3 2 6 2 6 7 4 1 3 3 3 1 3 1 3 6 5 3 2 7 2 2 5 3 11 5

Readme

Source
raw.​githubusercontent.​com

ESLint-Formatter for Sublime Text 3

Sublime Text 3 Plugin to autoformat your javascript code according to the ESLint configuration files you already have.

This plugin formats but does not lint your code. To also enable linting, use this plugin in conjuction with SublimeLinter-eslint.

Installation

Linter installation

This Sublime Text Plugin depends on a valid installation of eslint version 3 or higher. To install eslint, follow the getting started guide: http://eslint.org/docs/user-guide/getting-started.

Plugin installation

Please use Package Control to install the linter plugin. This will ensure that the plugin will be updated when new versions are available. If you want to install from source so you can modify the source code, you probably know what you are doing so we won’t cover that here.

To install via Package Control, do the following:

  1. Within Sublime Text, bring up the Command Palette and type install. Among the commands you should see Package Control: Install Package. If that command is not highlighted, use the keyboard or mouse to select it. There will be a pause of a few seconds while Package Control fetches the list of available plugins.

  2. When the plugin list appears, type eslint format. Among the entries you should see ESLint-Formatter. If that entry is not highlighted, use the keyboard or mouse to select it.

Commands

Command palette:

  • ESLintFormatter: Format this file

Shortcut key:

  • Linux/Windows: [Ctrl + Shift + H]
  • Mac: [Cmd + Shift + H]

Behavior

The formatting will be applied to the last saved state of a file, not the current buffer. If not using the format_on_save: true option, you have to save your file first and then run the command.

Settings

By default, ESLintFormatter will supply the following settings:

{
  // The Nodejs installation path
  "node_path": {
    "windows": "node.exe",
    "linux": "/usr/bin/nodejs",
    "osx": "/usr/local/bin/node"
  },

  // The location to search for a locally installed eslint package.
  // These are all relative paths to a project's directory.
  // If this is not found, it will try to fallback to a global package
  // (see 'eslint_path' below)
  "local_eslint_path": {
    "windows": "node_modules/eslint/bin/eslint.js",
    "linux": "node_modules/.bin/eslint",
    "osx": "node_modules/.bin/eslint"
  },

  // The location of the globally installed eslint package to use as a fallback
  "eslint_path": {
    "windows": "%APPDATA%/npm/node_modules/eslint/bin/eslint",
    "linux": "/usr/bin/eslint",
    "osx": "/usr/local/bin/eslint"
  },

  // Specify this path to an eslint config file to override the default behavior.
  // Passed to eslint as --config. Read more here:
  // http://eslint.org/docs/user-guide/command-line-interface#c---config
  // If an absolute path is provided, it will use as is.
  // Else, it will look for the file in the root of the project directory. 
  // Failing either, it will skip the config file
  "config_path": "",

  // Automatically format when a file is saved.
  "format_on_save": false,

  // Only attempt to format files with whitelisted extensions on save.
  // Leave empty to disable the check
  "format_on_save_extensions": [
    "js",
    "jsx",
    "es",
    "es6",
    "babel"
  ]
}
  • Modify any settings within the Preferences -> Package Settings -> ESLint-Formatter -> Settings - User file.

Project-specific settings override

To override global plugin configuration for a specific project, add a settings object with a ESLint-Formatter key in your .sublime-project. This file is accessible via Project -> Edit Project.

For example:

{
  "folders": [
    {
      "path": "."
    }
  ],
  "settings": {
    "ESLint-Formatter": {
      "format_on_save": true
    }
  }
}

Performance

If you experience performance issues, it may be worth taking a look at eslint_d. You can modify the settings to point to the eslint_d binary instead of eslint.

For example:

{
  "local_eslint_path": {
    "osx": "node_modules/.bin/eslint_d"
  }
}

Contributing

If you find any bugs feel free to report them here.

Pull requests are also encouraged.