Skip to main content

View colored, incremental diff in a workspace, annotated with messages from your favorite linter.

Project description


Term based tool to view colored, incremental diff in a Git/Mercurial/Svn workspace or from stdin, side by side with affected linting errors. Requires python (>= 2.7.0) and less.


Install with pip

Cdifflint is already listed on PyPI, you can install with pip if you have the tool.

pip install --upgrade cdifflint

Install with

You can also run the from the source if you don’t have pip.

git clone
cd cdifflint
./ install


Type cdifflint -h to show usage:

$ cdifflint -h
usage: cdifflint [-h] [-s] [-w N] [-l] [-c M] [-t {pep8,jslint,pyflakes}]

View colored, incremental diff in a workspace, annotated with messages from
your favorite linter.

optional arguments:
  -h, --help            show this help message and exit
  -s, --side-by-side    enable side-by-side mode
  -w N, --width N       set text width for side-by-side mode, 0 for auto
                        detection, default is 80
  -l, --log             show log with changes from revision control
  -c M, --color M       colorize mode 'auto' (default), 'always', or 'never'
  -t {pep8,jslint,pyflakes}, --lint {pep8,jslint,pyflakes}
                        run the given linters and show the lint messages in
                        the diff. Currently supports pep8, jslint, pyflakes.
                        (Can be specified multiple times)

Note: Option parser will stop on first unknown option and pass them down to
underneath revision control

See also

The original code I cribbed from heavily is the cdiff tool, which does most of the heavy lifting.

Change log

Version 1.0.0 (2016-12-14)

  • Working off cdiff version 0.9.8, can now show diffs, and also list any linter output within the diff.

Version 1.0.1 (2016-12-24)

  • Fixing distributed package so it actually installs

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

cdifflint-1.0.1-py2.py3-none-any.whl (8.9 kB view hashes)

Uploaded 3 6

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