Blank lines before class docstring are not removed

[jonathanberthias]

Describe the style change

The blank lines between a function's definition and its docstring currently get removed by Black. However, it does not do the same thing for classes.

Current Black changes

def f():

    """The line above gets removed."""
    return 0

becomes

def f():
    """The line above gets removed."""
    return 0

but

class C:

    """The line above stays."""

is not modified by Black.

Desired style

I would have expected that code to get reformatted as:

class C:
    """The line above stays."""

[huzaifakhan771]

This seems like the intended behavior. I tested it by adding more than one blank line after class definition, and it changed it to one line.

For example:

class C:



    """The line above stays."""

becomes

class C:

    """The line above stays."""

However, if I don't have any blank lines at all, it doesn't change it.

For example:

class C:
    """The line above stays."""

stays

class C:
    """The line above stays."""

So if the intended behavior is to have one blank line after class definition, it should stay consistent.

[st-pasha]

I agree with the OP that Black should enforce a consistent style in this case. There is no reason for a blank line to exist between a class/function declaration and the subsequent docstring.

[JelleZijlstra]

Agree, let's remove these blank lines.