This repository contains linting tools for Khan Academy's codebase.
It uses existing linting tools (pep8, pyflakes, jshint, etc), but has been modified to suit Khan Academy's slightly different style guides.
This repository also contains a wrapper scripts that can be used as a pre-commit hook for Git.
You should add the local bin/ directory to your system $PATH, for example:
export PATH=$PATH:~/path/to/khan-linter/bin
All dependencies are vendored within the repository itself, so no installation beyond cloning this repository is required.
If you would like to lint manually, invoke /path/to/runlint.py or ka-lint.
By default, this will lint all files under the current directory. Alternately, you can specify files on the command line to lint. See
ka-lint --help
for more options.
You can update the blacklist file in this repository to control what files
should not be linted at all. Alternately, you can create a blacklist of your
own, and use the --blacklist_file flag to runlint.py (you'll have to modify
hghook.py or githook.py to pass in the name of the blacklist file as well).
To suppress the lint check, set the environment variable FORCE_COMMIT=1 prior
to calling git commit.