Support numpy or Google docstrings

[leotrs]

Are there any plans to do this? Is this already implemented?

[Pacu2]

We could add a new flag --convention same as pydocstyle does.

[erwanp]

Would be a very nice feature !

[ubalklen]

While this is still open, I wonder what do people currently use to format their numpy/Google docstrings? I could not find any alternatives to docformatter, and it's hard to believe developers are doing this by hand and not losing their sanity in the process.

[mohammad7t]

I could not find any alternatives to docformatter

@ubalklen there is also https://github.com/dadadel/pyment

The last time I tried it, it had a problem that running pyment -w . (-w is for formatting files in-place) multiple times doesn't produce the same result (it keeps adding docstring for parameters that already have docstrings)

But that should be a solvable problem.

[ubalklen]

Thanks @mhsekhavat. I've just tried pyment, but it doesn't wrap long lines.

[Goldziher]

any update on this?

[weibullguy]

@Goldziher I recently started helping out with maintenance. I've been focusing on merging all the open PRs and addressing issues that were related to PEP 257 conventions. Once these are addressed, I'll release a new version (v1.5.0) of docformatter to PyPi. After that I plan to tackle the group of issues related to the various docstring styles (#43, #60, #68, #70, #78, #79). Once that group of issues is addressed, I'll release v1.6.0. Hopefully that'll happen in the next month or so.