flake8-max-function-length 0.7.1

Configurable flake8 plugin for maximum function length

flake8-max-function-length

A configurable flake8 plugin to enforce a maximum function/method length.

Installation

Install with pip

pip install flake8-max-function-length

Configuration Options

The package has only one rule MFL000 to check that function length is equal or lower to a maximum value. By default, the function length should be lower than 50 lines and is calculated based on its content ignoring its docstring, comments and empty lines. Still, you have the ability to customize that based on the following options:

• --max-function-length=n: Maximum allowed function length. (Default: 50)
• --mfl-include-function-definition: Include the function definition line(s) when calculating the function length. (Default: disabled)
• --mfl-include-docstring: Include the length of the docstring when calculating the function length. (Default: disabled)
• --mfl-include-empty-lines: Include empty lines inside the function when calculating the function length. (Default: disabled)
• --mfl-include-comment-lines: Include comment lines when calculating the function length. (Default: disabled)

Usage with pre-commit

repos:
  - repo: https://github.com/pycqa/flake8
    rev: '6.0.0'
    hooks:
      - id: flake8
        #args: [ --max-function-length, '100', --mfl-include-docstring, --mfl-include-comment-lines ]
        additional_dependencies: [ "flake8-max-function-length==0.7.1" ]

Changelog

[UNRELEASED]

[0.7.1] - 2023-02-18

Added

• Add badges to README.md and show it in PyPI
• Update the changelog when a release is created

[0.7.0] - 2023-02-18

Added

• Rule to enforce a limit on function/method length.
• Allow changing the maximum function length and how the function length is calculated via configuration options.

Similar tools

• flake8-functions has a similar rule for maximum function length, however, it doesn't exclude for empty lines and comments.
• Pylint has the too-many-statements rule, which is also similar to this one. Still, I find it easier to reason about number of lines as opposed to number of statements.

License

This project is MIT licensed.