lint-diff

:nail_care: Run eslint only in the changed parts of the code

Why

ESLint is a great tool to enforce code style in your code, but it has some limitations: it can only lint entire files. When working with legacy code, we often have to make changes to very large files (which would be too troublesome to fix all lint errors)and thus it would be good to lint only the lines changed and not the entire file.

lint-diff receives a commit range and uses ESLint to lint the changed files and filter only the errors introduced in the commit range (and nothing more).

State of the art

lint-staged is a similar tool that lints only the staged changes. It's very helpful for adding a precommit hook, but it cannot be used to enforce the styleguide on a Continuous Integration service like Travis, because the changes are already commited.

Usage

Install it:

$ npm install lint-diff

Install eslint and add your eslint configuration file.

Use it:

# This will lint the last commit
$ lint-diff HEAD^..HEAD

Examples

Lint the last 3 commits:

$ lint-diff HEAD~3..HEAD

Lint local changes that are not yet commited (similar to what lint-staged do):