Python Flake8 Lint

Python Flake8 Lint is a Sublime Text 2 (ST3) plugin for check Python files against some of the style conventions in PEP8, PyFlakes and mccabe.

Based on bitbucket.org/tarek/flake8.

Lint tools

Flake8 (used in "Python Flake8 Lint") is a wrapper around these tools:

• pep8 is a tool to check your Python code against some of the style conventions in PEP8.

• PyFlakes checks only for logical errors in programs; it does not perform any check on style.

• mccabe is a code complexity checker. It is quite useful to detect over-complex code. According to McCabe, anything that goes beyond 10 is too complex. See Cyclomatic_complexity.

Install

With the Package Control plug-in: The easiest way to install Python Flake8 Lint is through Package Control, which can be found at this site: http://wbond.net/sublime_packages/package_control

Once you install Package Control, restart ST2 (ST3) and bring up the Command Palette (Command+Shift+P on OS X, Control+Shift+P on Linux/Windows). Select "Package Control: Install Package", wait while Package Control fetches the latest package list, then select Python Flake8 Lint when the list appears. The advantage of using this method is that Package Control will automatically keep Python Flake8 Lint up to date with the latest version.

Manual installation: Download the latest source from GitHub, unzip it and rename the folder to "Python Flake8 Lint". Put this folder into your ST2 (ST3) "Packages" directory.

Or clone the repository to your ST2 (ST3) "Packages" directory:

git clone git://github.com/dreadatour/Flake8Lint.git "Python Flake8 Lint"

The "Packages" directory is located at:

• OS X:

    ~/Library/Application Support/Sublime Text 2/Packages/
  

• Linux:

    ~/.config/sublime-text-2/Packages/
  

• Windows:

    %APPDATA%/Sublime Text 2/Packages/
  

Config

Default Python Flake8 Lint config: "Preferences" -> "Package Settings" -> "Python Flake8 Lint" -> "Settings - Default"

{
	// run flake8 lint on file saving
	"lint_on_save": true,

	// run flake8 lint on file loading
	"lint_on_load": false,

	// popup a dialog of detected conditions?
	"popup": true,

	// highlight detected conditions?
	"highlight": true,

	// show a mark in the gutter on all highlighted lines:
	// - "dot", "circle" or "bookmark" to show marks
	// - "" (empty string) to do not show marks
	"gutter_marks": "",

	// report successfull (passed) lint
	"report_on_success": false,

	// set python interpreter (lint files for python >= 2.7):
	// - 'internal' for use internal Sublime Text 2 interpreter (2.6)
	// - 'auto' for search default system python interpreter (default value)
	// - absolute path to python interpreter for define another one
	//   use platform specific notation, i.e. "C:\\Anaconda\\envs\\py33\\python.exe"
	//   for Windows or then "/home/whatever/pythondist/python" for Unix
	"python_interpreter": "auto",

	// list of python built-in functions (like '_')
	"builtins": [],

	// turn on pyflakes error lint
	"pyflakes": true,
	// turn on pep8 error lint
	"pep8": true,
	// turn off complexity check (set number > 0 to check complexity level)
	"complexity": -1,

	// set desired max line length
	"pep8_max_line_length": 79,

	// select errors and warnings (e.g. ["E", "W6"])
	"select": [],
	// skip errors and warnings (e.g. ["E303", E4", "W"])
	"ignore": [],

	// files to ignore, for example: ["*.mako", "test*.py"]
	"ignore_files": []
}

To change default settings, go to "Preferences" -> "Package Settings" -> "Python Flake8 Lint" -> "Settings - User" and paste default config to the opened file and make your changes.

Note

Pep8 ignores "E24" errors by default. This plugin will not ignore them.

If you're not agree with this plugin, please, add next string in your config:

"ignore": ["E24"]

Features / Usage

Automatically check Python files with flake8 lint tool and show window with error list:

And move to error line/char on select.