Add Decorator node

[MichaReiser]

This PR introduces a new Decorator node. The node wraps an expression and its range includes the @.

Having a dedicated node for Decorators simplifies the implementation of the Formatter when handling leading comments:

@deco1
# leading 2
@deco2(with_args=True)
# leading 3
@deco3

# leading 4 that already has an empty line
def decorated_with_split_leading_comments():
    pass

The leading comment should be attached to the whole decorator and not just the expression coming after the @. It's also necessary that we distinguish between comments attached to the decorator vs comments attached to the decorator's expression:

@(
    # leading 3
    deco3
)

This is straightforward when the decorator and the expression are different nodes.

This change has the added benefit that the Linter now gets the full range of the decorator. For example, we have fixes that replace remove the whole decorator but they incorrectly assume that its safe to subtract 1 from the start (offset of the @). However, this doesn't account for:

@         deco2(with_args=True)
def decorated1():
    pass
    

which is valid python

[MichaReiser]

Current dependencies on/for this PR:

• main
  • PR Include argument parentheses in range #5
    • PR Add Decorator node #7 👈
    • PR NamedExpr include full range #6

This comment was auto-generated by Graphite.

[charliermarsh]

Great change.