Michael Schimmel
252b725677
This commit introduces the `DefDestructure` bound kind and modifies the binder, analyzer, type checker, and VM to support destructuring in `def` statements. This allows for pattern matching on the right-hand side of a `def` to bind multiple variables. The parser has been updated to accept patterns in `def` statements. The binder now handles `UntypedKind::Def` with a `target` pattern, rather than a simple `name`. This enables destructuring. The `Gemini.md` documentation has been updated to include a new rule for incremental development.
3.2 KiB
3.2 KiB
Rust-Portierung des Delphi-AST-Compilers
- Dieses Repository enthält den Rust-Port des Delphi-Compilers.
- Das Ziel ist, die alte Delphi-Codebase nach Rust zu portieren.
- Die alte Delphi-Codebase ist nicht zu verändern.
Wichtig: zentraler Einstiegspunkt ist Delphi/Myc.Ast.Environment.pasund die dort referenzierten Units.
Design
- Der AST soll 1st class citizen sein. Das Skript ist nur eine mögliche Art, ihn darzustellen.
- Ein geplante Darstellung des AST ist vollständige grafische Visualisierung.
- Es wird eine DSL für Finanzanalyse.
- Aufgrund der geforderten Visualisierbarkeit muss der untyped AST (das, was der User bearbeiten kann) möglichst simpel sein. Komplexität muss vom System übernommen werden.
- Closures sind Key-Feature.
Concurrency
- Die Root-Scopes sind die Grenze für Multithreading. Nichts verlässt den Root-Scope und alles innerhalb des Scope ist Single-Threaded.
- Globals sind nach dem Bootstrapping immutable.
- Das das Skript single-threaded ist, kann auf atomare Operationen (Mutex, Arc) verzichtet werden!
Spezielle Datentypen
- Serien sind "unendliche" Queues mit maximaler Länge (Lookback). Serie[0] ist das zuletzt gepushte Item.
- Streams sind virtuelle Konfigurationen aus Serien, die in der Lage sind einen neuen Item-Record zu propagieren.
- Pipes sind Streams mit einer weiteren Funktion: Sie können einen Stream als Input akzeptieren und einen anderen Stream als Output produzieren.
Portierungsregeln
- Wir wollen die Sprachfeatures von Rust nutzen.
- Der Code soll aber so gut wie möglich nach Rust-Style-Guidelines geschrieben werden.
- Dokumentation nach Rust-Regeln.
Interaktion
- Ich kann Rust noch nicht so gut. Erkläre mir, was du machst und welche Konzepte du nutzt. Ich will was dazulernen.
- Wenn clippy etwas vorschlägt, von dem du glaubst, dass es nicht stabil ist, dann überprüfe die aktuelle Version. Wahrscheinlich ist das Feature mittlerweile im trunk. Wir gehen immer davon aus, dass clippy recht hat.
- Keine Interaktion mit GIT. Kein Commit, oder ähnliches. Schlage auch nichts dergleichen vor.
- Gehe immer schrittweise vor. Zeige mir, was du vor hast, bevor du Code erzeugst.
Testing & Debugging
- Das Projekt enthält eine Testsuite für Skripte. Logik in src/utils/tester.rs. Diese Testes werden automatisch in "cargo test" eingebunden.
- Nach Fertigstellung einer Aufgabe, oder wenn ich zum Testen auffordere: Warnungen sind zu eliminieren. Tests müssen durchlaufen. Wenn alles funktioniert, muss auch clippy ohne Beanstandungen durchlaufen.
- Du kannst Skripte selbst testen! Nutze das ast-tool:
./target/release/ast.exe --help MYC AST Compiler & Benchmarker
Usage: ast.exe [OPTIONS] [FILE]
Arguments: [FILE] The script file to run or benchmark
Options: -e, --eval Run a script string directly -b, --bench Run benchmarks (Only allowed in Release mode) -u, --update-bench Update the benchmark baseline (Only allowed in Release mode) -d, --dump Dump the compiled AST -t, --trace Run with TracingObserver enabled --no-opt Disable optimization -h, --help Print help -V, --version Print version