Remove whitespaces in blank lines to be compliant with PEP 8 about docformatter HOT 4 CLOSED

I can't seem to reproduce the problem, can you give an example?

https://github.com/myint/docformatter/blob/7fa355102584e2d97e4a6251be9807d05c413d6f/test_docformatter.py#L253-L266

from docformatter.

@lordyavin can you confirm that your issue is given a docstring with the following whitespace

Summary line    \n
        \n
Elaborate description    \n

docformatter will strip the whitespaces after "line" and "description", but will leave untouched the whitespace on the line between. It is this un-removed whitespace on the blank line that pycodestyle complains about. docformatter should strip the whitespaces on the blank line as well.

This would be an enhancement to docformatter since the whitespace in the blank line is PEP-257 compliant, but not PEP-8 compliant.

from docformatter.

I'm sorry, I don't have access to the sources that I edited when I opened this issue and currently I don't use python very much. So I can't confirm your analysis.

from docformatter.

It may depend on the interpretation of PEP-257, which says Multi-line docstrings consist of a summary line just like a one-line docstring, followed by a blank line, together with The entire docstring is indented the same as the quotes at its first line (see example below)..

As the example has no whitespaces in the blank line, the second statement is not in effect for "blank lines", and PEP-257 seems to prefer the whitespaces removed.

In any case, I agree that this will be an enhancement; I usually run pydocformatter after applying Black, and Black removes the whitespaces for me.

from docformatter.