🚧🚧🚧🚧🚧 PLEASE NOTE NEW 2.0.0 VERSION WILL BE PUBLISHED SHORTLY FIXING ALL OUTDATED DEPENDENCIES 🚧🚧🚧🚧🚧
ESLint formatter aggregating results by rule
- aggregated errors / warnings per rule
- sort by rule name, number of errors or warnings
This formatter simply aggregates the ESLint results by rule and shows the following output:
It can also be configured to sort results by rule, errors or warnings using env vars e.g.
SORT_BY=rule DESC=true eslint -f summary ./src
(see details below).
npm i -D eslint-formatter-summary
// or
yarn add -D eslint-formatter-summary
When you run ESLint just specify eslint-formatter-summary
as the formatter:
eslint -f summary [file|dir|glob]*
See http://eslint.org/docs/user-guide/command-line-interface#-f---format
It is a matter of minutes to add ESLint to a new project, however it can be quite challenging to introduce it (or just add a stricter rule set) to existing projects, already large codebases.
Possibly hundreds if not thousands of errors will pop up which can seem overwhelming to be fixed when we see the default formatted output, forcing us to back up from making our code base better / more consistent.
This package provides a custom ESLint formatter to help in these situations to make the right decisions by showing the linting results aggregated by rule. It gives an overview of all rules failing showing the total number of errors and warnings summed up by rule.
Having this summary overview can give us the opportunity e.g. to consider suppressing certain rules for now and bringing them back in later when we are ready to fix them.
With the default ESLint formatter you might get several thousands of lines of failing rules in various files in the output e.g.:
The Summary Formatter simply aggregates the ESLint results by rule and shows the following output instead:
In the above example we can notice that the comma-dangle
rule is responsible for about 2/3 of the failures, so we can consider turning it off or just suppressing it to a warning for now as we can do so with the other failing rules.
Default sorting is by
rule
in anascending
order
Configuration options can be passed to the formatter to alter the output.
Using theSORT_BY
env var the aggregated results can be sorted by either rule
, errors
or warnings
e.g.
SORT_BY=rule eslint -f summary ./src
the sorted results are shown in ASCENDING order by default but the order can also be reversed using DESC=true
:
SORT_BY=rule DESC=true eslint -f summary ./src
The project used to support all Node.js version from v4.x
as this formatter is supposed to be an enabler for most projects and does not want to stand in the way by supporting only the latest Node.js versions.
However, time has passed and the project today is only tested on the latest LTS version of Node.js.
ESLint
versions are supported from v7
onwards, although eslint-formatter-summary
may also work with lower versions of ESLint. Please open an issue if you need support for other versions of ESLint.
Please feel free to submit an issue describing your proposal you would like to discuss. PRs are also welcome!
npm i
The project's code has been re-written using TypeScript as now it can rely on ESLint's exported types to make sure it is fully compatible with ESLint's data interface.
When changing code, you might want to run unit tests and re-build the project on file changes:
npm run test
npm run build
Once the project is built the distribution version can be tested via passing a .js
file to npm run try
.
For example:
npm run try test.js
In order to utilise Semantic Versioning each commit should be classified according to standard commitlint rules.
During the CI build all source files are linted and all unit tests need to pass resulting in a coverage report.
The project uses semantic versioning.
patch
versions are used to fix bugs and upgrade dependencies. minor
versions are used to add new non-breaking features. major
version is bumped when there are significant changes which could break projects already using eslint-formatter-summary
.
To publish a new version we use np
npm run release 1.2.3
See https://github.com/sindresorhus/np for more options.
- allow different output showing files with aggregated number of errors / warnings
- export results as JSON
- export each rule turned off and ready to be added to
.eslintrc
- show fixable summart #20
- export output as markdown #33
- show total number of files #34
- allow installing package on demand #35
MIT