docformatter
docformatter copied to clipboard
Wrapping doesn't work at all when there is an argument list?
I may be ignorant or missing something. Here are some examples:
"""Split audio at silences to keep under the size limit.
It's important to split near the middle of a silent section to prevent splitting on a spoken word and causing
issues with transcription and diarization.
Args:
silent_sections: list of silent sections in ms.
duration: total length of audio in ms
audio_size: total size of audio file in bytes
max_file_size: maximum file size that may exist after splits
Returns:
List of points in ms to use to split the audio file into chunks.
"""
Running docformatter on the above does nothing, unless I specify --force-wrap
which does what I want for the long line, but botches the argument list:
"""Split audio at silences to keep under the size limit.
It's important to split near the middle of a silent section to
prevent splitting on a spoken word and causing issues with
transcription and diarization.
Args: silent_sections: list of silent sections in ms.
duration: total length of audio in ms audio_size: total size of
audio file in bytes max_file_size: maximum file size that may
exist after splits
Returns: List of points in ms to use to split the audio file
into chunks.
"""
Compare to what happens if I remove the lists, and also remove --force-wrap
:
"""Split audio at silences to keep under the size limit.
It's important to split near the middle of a silent section to
prevent splitting on a spoken word and causing issues with
transcription and diarization.
"""
Is wrapping all or nothing; if there are lists no lines get wrapped? Or are my arg/returns lists malformed? Any insight is appreciated!