Fix: bt2: _trim_docstring(): docstring can have 0 or 1 line
authorPhilippe Proulx <eeppeliteloop@gmail.com>
Thu, 10 Sep 2020 20:47:52 +0000 (16:47 -0400)
committerPhilippe Proulx <eeppeliteloop@gmail.com>
Thu, 10 Sep 2020 22:07:55 +0000 (18:07 -0400)
commitade5c95e2a4f90f839f222fc1a66175b3b199922
tree0276fdcd31dc2b37dafda561786f5e5016fc549a
parente6938018975e45d35dab5fef795fe7344eef7d62
Fix: bt2: _trim_docstring(): docstring can have 0 or 1 line

It is possible that a user component class's docstring has no lines or a
single one, for example:

    # no line
    class MySink(bt2._UserSinkComponent):
        """"""

        def _user_consume(self):
            pass

    # single line
    class MySink(bt2._UserSinkComponent):
        """The single line"""

        def _user_consume(self):
            pass

The previous version of _trim_docstring() expects this format:

    class MySink(bt2._UserSinkComponent):
        """
        My sink's description

        Dolore officia ex et aliquip eiusmod enim pariatur reprehenderit
        ad adipisicing non occaecat ullamco aliquip laborum duis
        proident ex duis.

        Irure commodo proident esse non pariatur in aute cillum id aute.
        """

        def _user_consume(self):
            pass

In _trim_docstring(), accept no lines or a single one.

Adding new tests to `test_component_class.py` to validate this
behaviour. The

    # fmt: off
    """
    """
    # fmt: on

docstring has off/on formatting markers as Black 20.8b1 transforms this
into the non-equivalent

    """"""

(which is another test now).

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Change-Id: Ia12b0e9bfd4d1e1aaa86f0c8c207c3c1535f5c3e
Reviewed-on: https://review.lttng.org/c/babeltrace/+/4072
src/bindings/python/bt2/bt2/component.py
tests/bindings/python/bt2/test_component_class.py
This page took 0.025494 seconds and 4 git commands to generate.