Skip to main content

Flake8 wrapper to make it nice and configurable

Project description

It’s a Flake8 wrapper to make it cool.

  • Use only specified plugins, not everything installed.

  • Manage codes per plugin.

  • Enable and disable plugins and codes by wildcard.

  • Make output beautiful.

  • Show codes for installed plugins.

  • Show all messages and codes for a plugin.

  • Check that all required plugins are installed.

  • Syntax highlighting in messages and code snippets.

  • pyproject.toml support

  • sharable and remote configs.

output example

Installation

python3 -m pip install --user flakehell

Usage

First of all, let’s create pyproject.toml config:

[tool.flakehell]
# optionally inherit from remote config (or local if you want)
base = "https://gitlab.com/life4/flakehell/raw/master/pyproject.toml"
# specify any flake8 options. For example, exclude "example.py":
exclude = ["example.py"]
# make output nice
format = "grouped"
# 80 chars aren't enough in 21 century
max_line_length = 90
# show line of source code in output
show_source = true

# list of plugins and rules for them
[tool.flakehell.plugins]
# include everything in pyflakes except F401
pyflakes = ["+*", "-F401"]
# enable only codes from S100 to S199
flake8-bandit = ["-*", "+S1**"]
# enable everything that starts from `flake8-`
"flake8-*" = ["+*"]
# explicitly disable plugin
flake8-docstrings = ["-*"]
  • You can specify any flake8 settings in [tool.flakehell].

Show plugins that aren’t installed yet:

flakehell missed

Show installed plugins, used plugins, specified rules, codes prefixes:

flakehell plugins
plugins command output

Show codes and messages for a specific plugin:

flakehell codes pyflakes
codes command output

Run flake8 against the code:

flakehell lint

This command accepts all the same arguments as Flake8.

Formatters

Formatters make errors output nice. Available formatters:

  • colored – for humans.

  • grouped – also colored, but all messages are explicitly grouped by file.

  • json – no colors, only one json-dict per line for every error.

Also, you can specify show_source = true in the config to show line of source code where error occurred with syntax highlighting.

Colored:

colored

Colored with source code:

colored

Grouped:

grouped

Grouped with source code:

grouped

JSON:

json

Project details


Download files

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

Source Distribution

flakehell-0.1.1.tar.gz (18.1 kB view details)

Uploaded Source

Built Distribution

flakehell-0.1.1-py3-none-any.whl (22.3 kB view details)

Uploaded Python 3

File details

Details for the file flakehell-0.1.1.tar.gz.

File metadata

  • Download URL: flakehell-0.1.1.tar.gz
  • Upload date:
  • Size: 18.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.7

File hashes

Hashes for flakehell-0.1.1.tar.gz
Algorithm Hash digest
SHA256 94020ff350e0e84b6f538f7e7751bcb6ba730568ffb7a7692d75934c5b7f0354
MD5 aae771a82ec323f0b21a2728468803ea
BLAKE2b-256 a04f2c61deab78513c267a70a9c78460d66623f4e82494d0d38b08673090451e

See more details on using hashes here.

File details

Details for the file flakehell-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: flakehell-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 22.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.7

File hashes

Hashes for flakehell-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 60a9611647766b035902eae066b1a64cfbae84e318f07fe4a67c51b4995d5d84
MD5 47338ef822c9407c4af220bd06e73e11
BLAKE2b-256 06e8932a6c757b7e83983b08d4e9fbec279d3c9e185bfc5145e2625437786ba2

See more details on using hashes here.

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