Requirement Document generator tool

[Sebastian Huber]

----- Am 29. Jan 2020 um 23:48 schrieb Chris Johns chrisj at rtems.org:

> On 29/1/20 7:40 pm, Christian Mauderer wrote:
>> On 28/01/2020 23:15, Chris Johns wrote:
>>> On 28/1/20 10:22 pm, Christian Mauderer wrote:
[...]
>> If I understood you correctly your main problem with both suggested ones
>> (PEP8 and Google) is that multi line lists have been put together into
>> one liners and dictionaries with aligned fields are not aligned anymore?
> 
> They cannot be touched ...
> 
> https://git.rtems.org/rtems-source-builder/tree/source-builder/sb/darwin.py#n41
> https://git.rtems.org/rtems-source-builder/tree/source-builder/sb/freebsd.py#n50
> https://git.rtems.org/rtems-source-builder/tree/source-builder/sb/linux.py#n54
> https://git.rtems.org/rtems-source-builder/tree/source-builder/sb/linux.py#n104
> https://git.rtems.org/rtems-source-builder/tree/source-builder/sb/linux.py#n104
> https://git.rtems.org/rtems-source-builder/tree/source-builder/sb/options.py#n56
> https://git.rtems.org/rtems-libbsd/tree/libbsd.py#n59
> https://git.rtems.org/rtems-libbsd/tree/libbsd.py#n108
> https://git.rtems.org/rtems-libbsd/tree/libbsd.py#n148
> 
> I could go on but I think this list should highlight the issue.

The YAPF guide explicitly mentions this issue (Why does YAPF destroy my awesome formatting?):

https://github.com/google/yapf#why-does-yapf-destroy-my-awesome-formatting

You can disable the formatting in selected areas with

# yapf: disable/enable

comments.

black has a similar feature:

https://github.com/psf/black#the-black-code-style