Bear proposal docformatter

[jayvdb]

https://github.com/myint/docformatter

[satwikkansal]

As docformatter gives output in unified diff format, we should wait for the PR for coala/coala#3733 to get merged.

[Makman2]

See also #699 for a more generic approach.

[jayvdb]

As docformatter gives output in unified diff format, we should wait for the PR for coala/coala#3733 to get merged.

Err, docformatter --in-place would be more efficient and less error prone that parsing unified diff.

[satwikkansal]

docformatter --in-place actually modifies the file directly before prompting the user.

Ah, did you mean,

• Keeping a copy of the original_file
• Running the docformatter --in-place
• In the process_output reading the original file contents.
• Rewrite the original file to the earlier version (the version before docformatter --in-place was run)
• Passing the new contents read to the process_output_corrected function to generate the results.

I earlier thought this would be a hacky approach (discussed similar approach in the channel).

Should I change my approach? Also, the unified diff approach is working as expected in my PC.

[Makman2]

This behaviour is not easy to implement with @linter (while avoiding reinventing the wheel), and I would rather use the unified-diff. Less I/O + more functionality for @linter imo.