Add wrapping example using parentheses and backslashes

[gmikhail]

Code examples taken from here: https://www.reddit.com/r/godot/comments/co3pu2/comment/ewfp2dy/

[mhilbrunner]

Looks good to me.

[AThousandShips]

I'm unsure if we should suggest the parentheses version, we discourage unnecessary parentheses and these are unnecessary as the continuation method exists

Let's get an opinion from the GDScript team

[gmikhail]

Let me clarify that the main goal of this PR is to demonstrate all possible line wrapping options.

You can highlight a recommended option, but it's good practice to show all the available options.

[AThousandShips]

Sure, but the same page says using parentheses unnecessarily is bad practice, so it doesn't make sense to me to have a later example that contradict it, parentheses around the conditions is not GDScript style, this is a style guide, not instructions on how to wrap lines in general IMO

[mhilbrunner]

cc @dalexeev / @godotengine/gdscript

[dalexeev]

I think there should only be one recommended style on this page. The fact that backslash can be used to wrap long lines is already mentioned in the GDScript reference: one, two.

But indeed, the style guide does not answer which option is preferable. Looking at GDScript reference, Python, gdlint and the formatter PR, the preferred style seems to be parentheses (however, the number of tabs/spaces and the position of parentheses is unclear). This option is also more VCS-friendly.

On the other hand, when adding a new rule to the style guide, we should look at the established practices in the community. What style do we use in demo projects, what style do popular addons and projects use?

[dalexeev]

    if ($Sprite.animation == "back_crouch"
            or $Sprite.animation == "front_crouch"
            or $Sprite.animation == "horizontal_crouch"
    ):
        do_something()

or

    if (
            $Sprite.animation == "back_crouch"
            or $Sprite.animation == "front_crouch"
            or $Sprite.animation == "horizontal_crouch"
    ):
        do_something()

or

    if (
        $Sprite.animation == "back_crouch"
        or $Sprite.animation == "front_crouch"
        or $Sprite.animation == "horizontal_crouch"
    ):
        do_something()

?

[Calinou]

I tend to use the second one personally, as it's what the GDScript style guide recommends.