docstring-first-line-empty / C0199ΒΆ

Message emitted:

First line empty in %s docstring

Description:

Used when a blank line is found at the beginning of a docstring.

Problematic code:

def foo():  # [docstring-first-line-empty]
    """

    Lorem Ipsum is simply dummy text of the printing and typesetting
    industry.

    Lorem Ipsum has been the industry's standard dummy text ever since the
    1500s, when an unknown printer took a galley of type and scrambled it
    to make a type specimen book
    """

Correct code:

def foo():
    """Lorem Ipsum is simply dummy text of the printing and typesetting
    industry.

    Lorem Ipsum has been the industry's standard dummy text ever since the
    1500s, when an unknown printer took a galley of type and scrambled it
    to make a type specimen book
    """

Configuration file:

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

Note

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

Created by the docstyle checker.