Now we just need to figure out how to flake8-enforce that...

At least delete D213 ignore from.flake8. Not sure if that's enough. It may be that the due to the default docstring convention in pydocstyle/flake8-docstrings D213 is still not checked. In that case one needs to dig through flake8/flake8-docstrings/pydocstyle to find out how to explicitly activate it.

Removing it doesn't enforce the check (I tried), and in any case it's not actually fully fixed yet because there's still a problem with single-line docstrings which don't fit in one line when the quotes are in the same line, but do if the quotes are not there. This was raised at least once on the pydocstyle tracker (should be easy to find) and last time I check their response was basically "don't write single-line docstrings of just the line that's annoying"...

sure, done

there's still a problem with single-line docstrings which don't fit in one line when the quotes are in the same line, but do if the quotes are not there.

That's a separate error code: D200. I think D213 still allows

def foo():    """    Single line.    """

This was raised at least once on the pydocstyle tracker (should be easy to find) and last time I check their response was basically "don't write single-line docstrings of just the line that's annoying"...

There wasPyCQA/pydocstyle#184 with D205 and D400 errors if you have very long first sentences that need to be wrapped. - IMHO they would be relatively easy to fix, but the issue was closed.

Additionally, I openedPyCQA/pydocstyle#453, because D200 cannot be fulfilled for docstrings withmax. line length - 6 < text length + indent <= max. line length. This is a bit harder to fix, because pycodestyle would need to know about my line limit to allow for an exception.

For now, this means that we cannot check D200, 205, D400, because I don't think we want to or even reasonably can rewrite the first sentence to be descrpitive and fit in 69 chars (or 65 for methods) in all cases.

ok, removed D213 from .flake8, we'll see how this goes...

Just checked PEP-257 again on multi-line docstrings:

The summary line may be used by automatic indexing tools; it is important that it fits on one line and is separated from the rest of the docstring by a blank line.

So, if one plays strictly by the rules, it's viable to closePyCQA/pydocstyle#184 and require the authors to instead shorten the docstring. :sad: Though I don't think that's a reasonable way.

I'm not sure how it matters here (this is not about requiring a single-line summary) or even if an exegesis of PEP257 makes sense, but if we're going to go that route note that PEP257 contains the example (verbatim)

def foo():    """    This is the second line of the docstring.    """

so "triple-quotes + newline + single-line-docstring + newline + triple-quotes" is apparently allowed.