Summary
The "Repository Structure" section of AGENTS.md still describes the pre-crates/ layout, so every path in it is wrong. CONTRIBUTING.md § "Code organization" already describes the current layout, and the two documents now contradict each other.
Details
AGENTS.md L16-L31:
AGENTS.md says |
actual |
vm/ |
crates/vm/ |
compiler/ |
crates/compiler/ |
compiler/parser/ |
gone. Parsing is ruff_python_parser |
compiler/core/ |
crates/compiler-core/ |
compiler/codegen/ |
crates/codegen/ (a sibling crate, not a subdirectory) |
derive/ |
crates/derive/ (plus crates/derive-impl/) |
common/ |
crates/common/ |
stdlib/ |
crates/stdlib/ |
jit/ |
crates/jit/ |
pylib/ |
crates/pylib/ |
wasm/ |
still exists, but now holds demo/, notebook/, tests/, example/. The crate moved to crates/wasm/ |
Not listed at all: crates/capi, crates/host_env, crates/literal, crates/unicode, crates/wtf8, crates/sre_engine, crates/doc, crates/venvlauncher, crates/compiler-source.
Also minor, in the same file:
|
This document provides guidelines for working with GitHub Copilot when contributing to the RustPython project. |
still reads "GitHub Copilot Instructions for RustPython", though the file is now
AGENTS.md and is read by several agents.
Possible fixes
- Rewrite the section to match the current tree.
- Drop the section and point at
CONTRIBUTING.md § "Code organization" instead, so there is only one copy to keep current.
Related to #8356, which covers the broken DEVELOPMENT.md links in this same file. That is a separate problem from the structure list.
Drafted with AI assistance (Claude Code) and reviewed by me before posting.
Summary
The "Repository Structure" section of
AGENTS.mdstill describes the pre-crates/layout, so every path in it is wrong.CONTRIBUTING.md§ "Code organization" already describes the current layout, and the two documents now contradict each other.Details
AGENTS.mdL16-L31:AGENTS.mdsaysvm/crates/vm/compiler/crates/compiler/compiler/parser/ruff_python_parsercompiler/core/crates/compiler-core/compiler/codegen/crates/codegen/(a sibling crate, not a subdirectory)derive/crates/derive/(pluscrates/derive-impl/)common/crates/common/stdlib/crates/stdlib/jit/crates/jit/pylib/crates/pylib/wasm/demo/,notebook/,tests/,example/. The crate moved tocrates/wasm/Not listed at all:
crates/capi,crates/host_env,crates/literal,crates/unicode,crates/wtf8,crates/sre_engine,crates/doc,crates/venvlauncher,crates/compiler-source.Also minor, in the same file:
RustPython/AGENTS.md
Line 3 in 04c3ecf
AGENTS.mdand is read by several agents.Possible fixes
CONTRIBUTING.md§ "Code organization" instead, so there is only one copy to keep current.Related to #8356, which covers the broken
DEVELOPMENT.mdlinks in this same file. That is a separate problem from the structure list.Drafted with AI assistance (Claude Code) and reviewed by me before posting.