ruff/crates/ruff_python_parser/resources/valid/statement/function.py
Dhruv Manilawala 13ffb5bc19
Replace LALRPOP parser with hand-written parser (#10036)
(Supersedes #9152, authored by @LaBatata101)

## Summary

This PR replaces the current parser generated from LALRPOP to a
hand-written recursive descent parser.

It also updates the grammar for [PEP
646](https://peps.python.org/pep-0646/) so that the parser outputs the
correct AST. For example, in `data[*x]`, the index expression is now a
tuple with a single starred expression instead of just a starred
expression.

Beyond the performance improvements, the parser is also error resilient
and can provide better error messages. The behavior as seen by any
downstream tools isn't changed. That is, the linter and formatter can
still assume that the parser will _stop_ at the first syntax error. This
will be updated in the following months.

For more details about the change here, refer to the PR corresponding to
the individual commits and the release blog post.

## Test Plan

Write _lots_ and _lots_ of tests for both valid and invalid syntax and
verify the output.

## Acknowledgements

- @MichaReiser for reviewing 100+ parser PRs and continuously providing
guidance throughout the project
- @LaBatata101 for initiating the transition to a hand-written parser in
#9152
- @addisoncrump for implementing the fuzzer which helped
[catch](https://github.com/astral-sh/ruff/pull/10903)
[a](https://github.com/astral-sh/ruff/pull/10910)
[lot](https://github.com/astral-sh/ruff/pull/10966)
[of](https://github.com/astral-sh/ruff/pull/10896)
[bugs](https://github.com/astral-sh/ruff/pull/10877)

---------

Co-authored-by: Victor Hugo Gomes <labatata101@linuxmail.org>
Co-authored-by: Micha Reiser <micha@reiser.io>
2024-04-18 17:57:39 +05:30

162 lines
2.3 KiB
Python

def no_parameters():
pass
def positional_parameters(a, b, c):
pass
def positional_parameters_with_default_values(a, b=20, c=30):
pass
def positional_parameters_with_default_values2(a, b=20, /, c=30):
pass
def positional_only_and_positional_parameters(a, /, b, c):
pass
def pos_args_with_defaults_and_varargs_and_kwargs(a, b=20, /, c=30, *args, **kwargs):
pass
def keyword_only_parameters(*, a, b, c):
pass
def keyword_only_parameters_with_defaults(*, a, b=20, c=30):
pass
def kw_only_args_with_defaults_and_varargs(*args, a, b=20, c=30):
pass
def kw_only_args_with_defaults_and_kwargs(*, a, b=20, c=30, **kwargs):
pass
def kw_only_args_with_defaults_and_varargs_and_kwargs(*args, a, b=20, c=30, **kwargs):
pass
def pos_and_kw_only_args(a, b, /, c, *, d, e, f):
pass
def pos_and_kw_only_args_with_defaults(a, b, /, c, *, d, e=20, f=30):
pass
def pos_and_kw_only_args_with_defaults_and_varargs(a, b, /, c, *args, d, e=20, f=30):
pass
def pos_and_kw_only_args_with_defaults_and_kwargs(
a, b, /, c, *, d, e=20, f=30, **kwargs
):
pass
def pos_and_kw_only_args_with_defaults_and_varargs_and_kwargs(
a, b, /, c, *args, d, e=20, f=30, **kwargs
):
pass
def positional_and_keyword_parameters(a, b, c, *, d, e, f):
pass
def positional_and_keyword_parameters_with_defaults(a, b, c, *, d, e=20, f=30):
pass
def positional_and_keyword_parameters_with_defaults_and_varargs(
a, b, c, *args, d, e=20, f=30
):
pass
def positional_and_keyword_parameters_with_defaults_and_varargs_and_kwargs(
a, b, c, *args, d, e=20, f=30, **kwargs
):
pass
# Function definitions with type parameters
def func[T](a: T) -> T:
pass
def func[T: str](a: T) -> T:
pass
def func[T: (str, bytes)](a: T) -> T:
pass
def func[*Ts](*a: *Ts) -> Tuple[*Ts]:
pass
def func[**P](*args: P.args, **kwargs: P.kwargs):
pass
def func[T, U: str, *Ts, **P]():
pass
def ellipsis(): ...
def multiple_statements() -> int:
call()
pass
...
def foo(*args):
pass
def foo(**kwargs):
pass
def foo(*args, **kwargs):
pass
def foo(a, /):
pass
def foo(a, /, b):
pass
def foo(a=1, /,):
pass
def foo(a, b, /, *, c):
pass
def foo(kw=1, *, a):
pass
def foo(x: int, y: "str", z: 1 + 2):
pass
def foo(self, a=1, b=2, c=3):
pass