Missing indentation as in example

[bagustris]

I follow the example in the readme,

Intead of getting this,

def launch_rocket():
    """Launch the rocket.

    Go colonize space.
    """

I got this (no change) ,

def launch_rocket():
    """Launch
the
rocket. Go colonize space."""
 """

Command used: docformatter --in-place example.py

[weibullguy]

The reason this is not being formatted is this code:

if (
    len(split_lines) / max([len(line.strip()) for line in split_lines] + [1])
    > HEURISTIC_MIN_LIST_ASPECT_RATIO
) and not strict:
    return True

where HEURISTIC_MIN_LIST_ASPECT_RATIO = 0.4, The purpose of this code is to prevent docformatter from formatting things like this:

Example:
          release-1.1/
          release-1.2/
          release-1.3/
          release-1.4/
          release-1.4.1/
          release-1.5/

The example code below calculates to 0.43 and, therefore, is left unformatted:

Launch
the
rocket.

There is a TODO to find a better way to handle these instances (and any input is welcome). One option that comes to mind is not just to skip text blocks that look like they might be lists, but to also capture them and print a message at the end of the docformatter run to inform the user that they were ignored and will need to be manually fixed. In the meantime, I'm going to simply update the README with a new example. Any feedback on how the user-base would prefer docformatter handle these potential lists would be welcome. You can comment in this issue.