differing-type-doc / W9018#

Message emitted:

"%s" differing in parameter type documentation

Description:

Please check parameter names in type declarations.

Problematic code:

def add(x: int, y: int):  # [differing-type-doc]
    """Add two numbers.

    :param int xy: x value.
    :param str y: y value.
    """

    return x + y

Correct code:

def add(x, y):
    """Add two numbers.

    :param int x: x value.
    :param int y: y value.
    """

    return x + y

Configuration file:

[MAIN]
load-plugins = pylint.extensions.docparams

Note

This message is emitted by the optional 'parameter_documentation' checker, which requires the pylint.extensions.docparams plugin to be loaded.

Created by the parameter_documentation checker.