flake8-functions 0.0.4

A flake8 extension that checks functions

flake8-functions

An extension for flake8 to report on issues with functions.

We believe code readability is very important for a team that consists of more than one person. One of the issues we've encountered is functions that are more that two screens long.

The validator checks for:

• CFQ001 - function length (default max length is 100)
• CFQ002 - function arguments number (default max arguments amount is 6)

Installation

pip install flake8-functions

Example

def some_long_function(
    first_parameter: int,
    second_parameter: int,
    third_parameter: int,
):
    first_parameter = (
        first_parameter +
        second_parameter +
        third_parameter
    )

    first_parameter = (
        first_parameter +
        second_parameter +
        third_parameter
    )

    first_parameter = (
        first_parameter +
        second_parameter +
        third_parameter
    )

    first_parameter = (
        first_parameter +
        second_parameter +
        third_parameter
    )

    return first_parameter

Usage:

$ flake8 --max-function-length=20 test.py
test.py:1:0: CFQ001 "some_long_function" function has length 25 that exceeds max allowed length 20

Tested on Python 3.6 and 3.7.2 and flake8 3.7.5.

Error codes

Error code	Description
CFQ001	Function "some_function" has length <function_length> that exceeds max allowed length <max_length>
CFQ002	Function "some_function" has <args_amount> arguments that exceeds max allowed <max_args_amount>

Contributing

We would love you to contribute to our project. It's simple:

1. Create an issue with bug you found or proposal you have. Wait for approve from maintainer.
2. Create a pull request. Make sure all checks are green.
3. Fix review comments if any.
4. Be awesome.

Here are useful tips:

• You can run all checks and tests with make check. Please do it before TravisCI does.
• We use BestDoctor python styleguide. Sorry, styleguide is available only in Russian for now.
• We respect Django CoC. Make soft, not bullshit.