ESLint-Formatter
Sublime Text 3 Plugin to Autoformat with Eslint
Details
Installs
- Total 49K
- Win 18K
- Mac 23K
- Linux 9K
Dec 3 | Dec 2 | Dec 1 | Nov 30 | Nov 29 | Nov 28 | Nov 27 | Nov 26 | Nov 25 | Nov 24 | Nov 23 | Nov 22 | Nov 21 | Nov 20 | Nov 19 | Nov 18 | Nov 17 | Nov 16 | Nov 15 | Nov 14 | Nov 13 | Nov 12 | Nov 11 | Nov 10 | Nov 9 | Nov 8 | Nov 7 | Nov 6 | Nov 5 | Nov 4 | Nov 3 | Nov 2 | Nov 1 | Oct 31 | Oct 30 | Oct 29 | Oct 28 | Oct 27 | Oct 26 | Oct 25 | Oct 24 | Oct 23 | Oct 22 | Oct 21 | Oct 20 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 1 | 0 | 1 | 2 | 2 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 0 | 1 | 1 | 0 | 2 | 0 | 0 | 0 | 2 | 1 | 0 | 1 | 0 | 3 | 2 | 3 | 3 | 2 | 1 | 1 | 0 | 1 | 1 | 3 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 1 |
Mac | 1 | 2 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | 1 | 1 | 1 | 1 | 0 | 0 | 1 | 0 | 0 | 1 | 1 | 0 | 1 | 1 | 0 | 0 | 0 | 1 | 0 | 1 | 1 | 1 | 1 | 1 | 0 | 0 | 0 | 3 | 3 | 0 | 1 | 1 | 0 |
Linux | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 1 | 2 | 0 | 0 | 0 | 1 | 0 | 0 | 2 | 0 | 0 | 1 | 0 | 1 | 3 | 2 | 0 | 1 | 0 | 0 | 2 | 0 | 1 | 1 |
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:
Within Sublime Text, bring up the Command Palette and type
install
. Among the commands you should seePackage 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.When the plugin list appears, type
eslint format
. Among the entries you should seeESLint-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
// If these are false, we'll invoke the eslint binary directly.
"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 or are false, 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": "",
// Specify the name of a config file, which determines the root of your
// project. This is a pattern such as ".eslintrc.json" or "package.json"
// and will be searched for upwards, to determine the working directory
// for linting. This is different to config_path and is only used for
// resolving the working directory.
"config_file": "",
// Pass additional arguments to eslint.
//
// Each command should be a string where it supports the following replacements:
// $project_path - The path to the projects root folder
//
// Example:
// ["--parser-options={\"tsconfigRootDir\": \"$project_path\"}"]
"extra_args": [],
// Automatically format when a file is saved.
"format_on_save": false,
// Use --fix-to-stdout, --stdin, and --stdin-filename to update the file if using eslint_d.
// See https://github.com/mantoni/eslint_d.js#automatic-fixing
"fix_to_stdout": 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.