D413 problems since pydocstyle 4.0.0

[MarkusPiotrowski]

Updating pydocstyle from version 3.0.0 to version 4.0.0 or 4.0.1 throw numerous new D413 (and few D412) issues on code that passes with version 3.0.0.

Example: The following code:

"""Test module to demonstrate D413 problem."""


def example_1(one, two):
    """Demonstrate case.

    Arguments:
     - one      first argument
     - second   second argument

    This function shows if a D413 is thrown or not.
    In my view, this is not a D413.
    """
    pass


def example_2(one, two):
    """Demonstrate case.

    Attributes:
     - one      first attribute
     - second   second attribute

    This function shows if a D413 is thrown or not.
    In my view, this is not a D413.
    """
    pass


# Original PEP-257 example from https://www.python.org/dev/peps/pep-0257/:
def complex(real=0.0, imag=0.0):
    """Form a complex number.

    Keyword arguments:
    real -- the real part (default 0.0)
    imag -- the imaginary part (default 0.0)
    """
    if imag == 0.0 and real == 0.0:
        return complex_zero

throws 'only' one issue with pydocstyle ver. 3.0.0:

>pydocstyle --version
3.0.0

>pydocstyle D413_example.py
D413_example.py:18 in public function `example_2`:
        D413: Missing blank line after last section ('Attributes')

but 4 with ver. 4.0.1 (or 4.0.0), even with the original PEP-257 example (from https://www.python.org/dev/peps/pep-0257/):

>pydocstyle --version
4.0.1

>pydocstyle D413_example.py
D413_example.py:5 in public function `example_1`:
        D413: Missing blank line after last section ('Arguments')
D413_example.py:18 in public function `example_2`:
        D413: Missing blank line after last section ('Attributes')
D413_example.py:18 in public function `example_2`:
        D413: Missing blank line after last section ('Attributes')
D413_example.py:32 in public function `complex`:
        D413: Missing blank line after last section ('Keyword Arguments')

Actually, I think that no of these example docstrings should give an issue (at least in pep257 mode). The only way to get rid of this error is to put an empty line before the closing quotes, but this isn't a PEP 257 rule?

[samj1912]

From what I can see, the change that causes D413 to be throw is the addition of new section names in pydocstyle 4.0. Earlier Arguments or Keyword Arguments were not identified as sections, and as a result they never threw D413. Given the examples, it seems reasonable to exclude D413 from the pep257 convention entirely.