Descriptions and examples for the rules in Flake8 (pyflakes, pycodestyle, and mccabe).
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Flake8 Rules

Documentation and examples for the rules in Flake8 (pyflakes, pycodestyle, and mccabe).


Flake8 Rules includes simple API with two endpoints.

Retrieve a single rule

This endpoints returns a single Flake8 rule.

Heads up: This endpoint returns JSON content but the Content-Type is set to text/html. This is due to Jekyll's inability to generate files with permalinks that end in .json.

$ curl
    "code": "E111",
    "message": "Indentation is not a multiple of four",
    "content": "The rendered HTML content",
    "links": [""]
  • code - The 4 character Flake8 issue code.
  • message - A short message describing the issue.
  • content - The fully rendered HTML content describing the issue and how to fix it.
  • links - A list of additional links to visit for more information.

Retrieve a list of all rules

This endpoint returns a list of all Flake8 rules.

$ curl
        "code": "F812",
        "message": "List comprehension redefines name from line n",
        "content": "The rendered HTML content",
        "links": [""]


All rules go in the _rules directory. They should be named with their 4 character code, like

To run the jekyll development server first install Jekyll. Then run the following:

$ bundle exec jekyll serve