ruff/crates/ruff_python_parser/tests/snapshots/valid_syntax@expressions__tuple.py.snap
Ibraheem Ahmed c9dff5c7d5
[ty] AST garbage collection (#18482)
## Summary

Garbage collect ASTs once we are done checking a given file. Queries
with a cross-file dependency on the AST will reparse the file on demand.
This reduces ty's peak memory usage by ~20-30%.

The primary change of this PR is adding a `node_index` field to every
AST node, that is assigned by the parser. `ParsedModule` can use this to
create a flat index of AST nodes any time the file is parsed (or
reparsed). This allows `AstNodeRef` to simply index into the current
instance of the `ParsedModule`, instead of storing a pointer directly.

The indices are somewhat hackily (using an atomic integer) assigned by
the `parsed_module` query instead of by the parser directly. Assigning
the indices in source-order in the (recursive) parser turns out to be
difficult, and collecting the nodes during semantic indexing is
impossible as `SemanticIndex` does not hold onto a specific
`ParsedModuleRef`, which the pointers in the flat AST are tied to. This
means that we have to do an extra AST traversal to assign and collect
the nodes into a flat index, but the small performance impact (~3% on
cold runs) seems worth it for the memory savings.

Part of https://github.com/astral-sh/ty/issues/214.
2025-06-13 08:40:11 -04:00

808 lines
36 KiB
Text

---
source: crates/ruff_python_parser/tests/fixtures.rs
input_file: crates/ruff_python_parser/resources/valid/expressions/tuple.py
---
## AST
```
Module(
ModModule {
node_index: AtomicNodeIndex(..),
range: 0..276,
body: [
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 19..21,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 19..21,
elts: [],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 22..26,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 23..25,
elts: [],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 27..37,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 27..37,
elts: [
Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 29..31,
elts: [],
ctx: Load,
parenthesized: true,
},
),
Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 34..36,
elts: [],
ctx: Load,
parenthesized: true,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 38..42,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 38..42,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 39..40,
id: Name("a"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 43..49,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 43..49,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 44..45,
id: Name("a"),
ctx: Load,
},
),
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 47..48,
id: Name("b"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 50..57,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 50..57,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 51..52,
id: Name("a"),
ctx: Load,
},
),
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 54..55,
id: Name("b"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 58..66,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 59..65,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 60..61,
id: Name("a"),
ctx: Load,
},
),
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 63..64,
id: Name("b"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 90..92,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 90..92,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 90..91,
id: Name("a"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: false,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 93..97,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 93..97,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 93..94,
id: Name("a"),
ctx: Load,
},
),
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 96..97,
id: Name("b"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: false,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 98..103,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 98..103,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 98..99,
id: Name("a"),
ctx: Load,
},
),
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 101..102,
id: Name("b"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: false,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 126..129,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 126..129,
elts: [
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 126..128,
value: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 127..128,
id: Name("a"),
ctx: Load,
},
),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: false,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 130..135,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 130..135,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 130..131,
id: Name("a"),
ctx: Load,
},
),
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 133..135,
value: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 134..135,
id: Name("b"),
ctx: Load,
},
),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: false,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 136..161,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 136..161,
elts: [
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 136..142,
value: BinOp(
ExprBinOp {
node_index: AtomicNodeIndex(..),
range: 137..142,
left: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 137..138,
id: Name("a"),
ctx: Load,
},
),
op: BitOr,
right: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 141..142,
id: Name("b"),
ctx: Load,
},
),
},
),
ctx: Load,
},
),
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 144..152,
value: Await(
ExprAwait {
node_index: AtomicNodeIndex(..),
range: 145..152,
value: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 151..152,
id: Name("x"),
ctx: Load,
},
),
},
),
ctx: Load,
},
),
Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 154..156,
elts: [],
ctx: Load,
parenthesized: true,
},
),
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 158..161,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 159..161,
elts: [],
ctx: Load,
parenthesized: true,
},
),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: false,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 162..167,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 162..167,
elts: [
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 163..165,
value: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 164..165,
id: Name("a"),
ctx: Load,
},
),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 168..175,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 168..175,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 169..170,
id: Name("a"),
ctx: Load,
},
),
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 172..174,
value: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 173..174,
id: Name("b"),
ctx: Load,
},
),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 176..203,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 176..203,
elts: [
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 177..183,
value: BinOp(
ExprBinOp {
node_index: AtomicNodeIndex(..),
range: 178..183,
left: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 178..179,
id: Name("a"),
ctx: Load,
},
),
op: BitOr,
right: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 182..183,
id: Name("b"),
ctx: Load,
},
),
},
),
ctx: Load,
},
),
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 185..193,
value: Await(
ExprAwait {
node_index: AtomicNodeIndex(..),
range: 186..193,
value: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 192..193,
id: Name("x"),
ctx: Load,
},
),
},
),
ctx: Load,
},
),
Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 195..197,
elts: [],
ctx: Load,
parenthesized: true,
},
),
Starred(
ExprStarred {
node_index: AtomicNodeIndex(..),
range: 199..202,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 200..202,
elts: [],
ctx: Load,
parenthesized: true,
},
),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 224..233,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 224..233,
elts: [
Named(
ExprNamed {
node_index: AtomicNodeIndex(..),
range: 225..231,
target: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 225..226,
id: Name("x"),
ctx: Store,
},
),
value: NumberLiteral(
ExprNumberLiteral {
node_index: AtomicNodeIndex(..),
range: 230..231,
value: Int(
1,
),
},
),
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 234..245,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 234..245,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 235..236,
id: Name("x"),
ctx: Load,
},
),
Named(
ExprNamed {
node_index: AtomicNodeIndex(..),
range: 238..244,
target: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 238..239,
id: Name("y"),
ctx: Store,
},
),
value: NumberLiteral(
ExprNumberLiteral {
node_index: AtomicNodeIndex(..),
range: 243..244,
value: Int(
2,
),
},
),
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 246..260,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 246..260,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 247..248,
id: Name("x"),
ctx: Load,
},
),
Named(
ExprNamed {
node_index: AtomicNodeIndex(..),
range: 250..256,
target: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 250..251,
id: Name("y"),
ctx: Store,
},
),
value: NumberLiteral(
ExprNumberLiteral {
node_index: AtomicNodeIndex(..),
range: 255..256,
value: Int(
2,
),
},
),
},
),
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 258..259,
id: Name("z"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: true,
},
),
},
),
Expr(
StmtExpr {
node_index: AtomicNodeIndex(..),
range: 261..275,
value: Tuple(
ExprTuple {
node_index: AtomicNodeIndex(..),
range: 261..275,
elts: [
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 261..262,
id: Name("x"),
ctx: Load,
},
),
Named(
ExprNamed {
node_index: AtomicNodeIndex(..),
range: 265..271,
target: Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 265..266,
id: Name("y"),
ctx: Store,
},
),
value: NumberLiteral(
ExprNumberLiteral {
node_index: AtomicNodeIndex(..),
range: 270..271,
value: Int(
2,
),
},
),
},
),
Name(
ExprName {
node_index: AtomicNodeIndex(..),
range: 274..275,
id: Name("z"),
ctx: Load,
},
),
],
ctx: Load,
parenthesized: false,
},
),
},
),
],
},
)
```