Sublime Text 2 plugin / check Python files with flake8 (PEP8, pyflake and mccabe)
Switch branches/tags
Nothing to show
Pull request Compare This branch is 122 commits behind dreadatour:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
Default (Linux).sublime-keymap
Default (OSX).sublime-keymap
Default (Windows).sublime-keymap

Python Flake8 Lint

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

Based on

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.


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:

Once you install Package Control, restart ST2 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 "Packages" directory.

Or clone the repository to your ST2 "Packages" directory:

git clone git:// "Python Flake8 Lint"

The "Packages" directory is located at:

  • OS X:

      ~/Library/Application Support/Sublime Text 2/Packages/
  • Linux:

  • Windows:

      %APPDATA%/Sublime Text 2/Packages/


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

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

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

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

	// 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
	"python_interpreter": "auto",

	// 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.


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:

Error list

And move to error line/char on select.