mirror of https://github.com/astral-sh/ruff.git synced 2025-08-03 18:28:56 +00:00

History

Brent Westbrook 97d0659ce3 Pass `ParserOptions` to the parser (#16220 ) ## Summary This is part of the preparation for detecting syntax errors in the parser from https://github.com/astral-sh/ruff/pull/16090/. As suggested in [this comment](https://github.com/astral-sh/ruff/pull/16090/#discussion_r1953084509), I started working on a `ParseOptions` struct that could be stored in the parser. For this initial refactor, I only made it hold the existing `Mode` option, but for syntax errors, we will also need it to have a `PythonVersion`. For that use case, I'm picturing something like a `ParseOptions::with_python_version` method, so you can extend the current calls to something like ```rust ParseOptions::from(mode).with_python_version(settings.target_version) ``` But I thought it was worth adding `ParseOptions` alone without changing any other behavior first. Most of the diff is just updating call sites taking `Mode` to take `ParseOptions::from(Mode)` or those taking `PySourceType`s to take `ParseOptions::from(PySourceType)`. The interesting changes are in the new `parser/options.rs` file and smaller parts of `parser/mod.rs` and `ruff_python_parser/src/lib.rs`. ## Test Plan Existing tests, this should not change any behavior.		2025-02-19 10:50:50 -05:00
..
resources	Modify parsing of raise with cause when exception is absent (#15049 )	2024-12-19 13:36:32 +00:00
src	Pass `ParserOptions` to the parser (#16220 )	2025-02-19 10:50:50 -05:00
tests	Pass `ParserOptions` to the parser (#16220 )	2025-02-19 10:50:50 -05:00
Cargo.toml	ruff_linter,ruff_python_parser: migrate to updated `annotate-snippets`	2025-01-15 13:37:52 -05:00
CONTRIBUTING.md	py-fuzzer: recommend using `uvx` rather than `uv run` to run the fuzzer (#14645 )	2024-11-27 22:19:52 +00:00
README.md	Add basic docs for the parser crate (#11199 )	2024-04-29 17:08:07 +00:00

README.md

Ruff Python Parser

Ruff's Python parser is a hand-written recursive descent parser which can parse Python source code into an Abstract Syntax Tree (AST). It also utilizes the Pratt parsing technique to parse expressions with different precedence.

Try out the parser in the playground.

Python version support

The parser supports the latest Python syntax, which is currently Python 3.12. It does not throw syntax errors if it encounters a syntax feature that is not supported by the target-version. This will be fixed in a future release (see https://github.com/astral-sh/ruff/issues/6591).

Contributing

Refer to the contributing guidelines to get started and GitHub issues with the parser label for issues that need help.