Skip to main content

Runs one or more linters, but only outputs errors if diffs have lint issues.

Project description

Build Status Code Coverage

lint-diffs

lint-diffs is a simple command line tool for running a set of arbitrarty linters on a set of 'unified diffs'.

Errors on diff-lines will always be reported. Errors on non-diff lines can also be reported, depending on severity.

First you need some diffs, then you pipe it to lint-diffs:

git diff -U0 origin/master | lint-diffs

... or in mercurial: hg outgoing -p | lint-diffs

The default and only preconfigured tool for python is "pylint".

Configuration:

lint-diffs will read a config files from ~/.config/lint-diffs and/or ./.lint-diffs.

Example:

[pylint]
always_report=E.*

[flake8]
extensions=.py

[rubocop]
extensions=.rb
always_report=(E.*|W.*)

[eslint]
extensions=.js

[shellcheck]
extensions=.sh

In this example, a flake8 and pylint are run on every diff file ending in .py. Additionally, ruby, eslint and shell script linters have been enabled. The ruby linter has been modified to always report warnings, on any changed file, not just changed lines.

To add new linters:

  • The linter has to report to stdout
  • The linter has to have a regex that produces a full file path, a line number and an error class
  • The line numbers and file paths have to match diff target file paths

To enable or disable linters change the 'extensions' config.

Goals:

  • Runs with good defaults for many people
  • Should be easy to modify the config for any linter
  • Should be easy to use with any vcs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lint_diffs-0.1.14.tar.gz (10.3 kB view hashes)

Uploaded Source

Built Distribution

lint_diffs-0.1.14-py3-none-any.whl (8.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page