Refactor: Use Symbol for identifiers and macro hygiene
Introduces a `Symbol` struct to represent identifiers, incorporating macro hygiene context. Updates various parts of the AST compiler and environment to use `Symbol` instead of raw `Rc<str>` for identifiers, improving robustness for macro expansions. Also includes: - Adds a new example `macro_hygiene.myc`. - Updates `.gitignore`. - Refactors `MacroExpander` to use `ExpansionState` for cleaner template expansion. - Adjusts `VM::eval_observed` to ensure `after_eval` is called correctly. - Resets `Environment` for each test run and compilation/dumping in `main.rs`.
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
## 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.pas
|
||||
und 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.
|
||||
Reference in New Issue
Block a user