""" Leading summary whitespace (as in this issue title).""" about docformatter HOT 8 CLOSED

--pre-summary-space matches the --pre-summary-newline option for naming, so would probably be the least confusing.

from docformatter.

@ndevenish Made a pull request adding this option. Mind trying it out?

from docformatter.

😮 I have seen extra spaces around a one-line docstring, or extra leading space on the first line of a multiline docstring, but didn’t know there was a style of one-line docstring with leading space but no trailing space.

from docformatter.

Note that black inserts the leading whitespace. Therefore if you use both black and docformatter you'll be in formatting limbo.

See psf/black#2912

from docformatter.

Also worth pointing out https://docs.python.org/3/library/inspect.html#inspect.cleandoc strips this, so it should have no semantic difference (help docs do not have the whitespace).

from docformatter.

Last comment, black only inserts the leading space if the first character is the quote, so it's obvious there's an extra quote. Otherwise there isn't a leading space.

E.g.

# Adds leading space
""" "I'm quoted"."""
# But also doesn't
"""I'm not quoted."""

So applying the space everywhere would still land you in limbo.

from docformatter.

@thejcannon thanks for pointing this out.

PR #46 is submitted to add the leading space. Once that PR is merged, using the --pre-summary-space option will maintain the black-inserted space. For those who prefer the non-space formatting they would need to run black first, then docformatter. I've asked the #46 pull requester to address this interaction in the README.

from docformatter.

Closed by #46

from docformatter.