ruff/crates/ruff_python_ast/src
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
..
visitor [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
comparable.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
docstrings.rs Move Python whitespace utilities into new ruff_python_whitespace crate (#4993) 2023-06-10 00:59:57 +00:00
expression.rs Implement template strings (#17851) 2025-05-30 15:00:56 -05:00
generated.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
helpers.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
identifier.rs Switch to Rust 2024 edition (#18129) 2025-05-16 13:25:28 +02:00
int.rs [ruff] Unnecessary cast to int (RUF046) (#14697) 2024-12-05 10:30:06 +01:00
lib.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
name.rs ty_ide: improve completions by using scopes 2025-05-29 10:31:30 -04:00
node.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
node_index.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
nodes.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
operator_precedence.rs Implement template strings (#17851) 2025-05-30 15:00:56 -05:00
parenthesize.rs Remove customizable reference enum names (#15647) 2025-01-21 13:46:31 -05:00
python_version.rs [ty] Infer the Python version from --python=<system installation> on Unix (#18550) 2025-06-11 14:32:33 +00:00
relocate.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
script.rs bump MSRV to 1.83 (#16294) 2025-02-26 06:12:43 -08:00
statement_visitor.rs Remove Stmt::TryStar (#6566) 2023-08-14 13:39:44 -04:00
stmt_if.rs Misc. small tweaks from perusing modules (#9383) 2024-01-03 12:30:25 -05:00
str.rs Implement template strings (#17851) 2025-05-30 15:00:56 -05:00
str_prefix.rs Implement template strings (#17851) 2025-05-30 15:00:56 -05:00
traversal.rs Use referencial equality in traversal helper methods (#13895) 2024-10-24 11:30:22 +02:00
types.rs Remove RefEquality (#6393) 2023-08-07 16:04:50 +00:00
visitor.rs [ty] AST garbage collection (#18482) 2025-06-13 08:40:11 -04:00
whitespace.rs Switch to Rust 2024 edition (#18129) 2025-05-16 13:25:28 +02:00