https://ctdi.pages.deinstapel.de/kalibriware/dokumentation/docs/entwicklerdokumentation/altskripte/ Recent content in Altskripte on KalibriWare - Dokumentation Hugo -- gohugo.io de https://ctdi.pages.deinstapel.de/kalibriware/dokumentation/docs/entwicklerdokumentation/altskripte/intro/ Mon, 01 Jan 0001 00:00:00 +0000 https://ctdi.pages.deinstapel.de/kalibriware/dokumentation/docs/entwicklerdokumentation/altskripte/intro/ Einführung Bei der im alten Kalibri integrierten Skriptsprache handelt es sich um eine komplette Eigenentwicklung. Sie kombiniert Ideen aus verschiedenen anderen Sprachen, nimmt dabei aber nur die Nachteile mit und lässt die Vorteile gezielt stehen. Die Skriptsprache ist historisch gewachsen und weist deswegen eine außergewöhnliche Menge an problematischen Designentscheidungen auf. Die Syntax ist überaus komplex, aber gleichzeitig sehr fehleranfällig und schlecht dokumentiert. Der dazugehörige Interpreter, welcher sich hauptsächlich in der Datei GPIB. https://ctdi.pages.deinstapel.de/kalibriware/dokumentation/docs/entwicklerdokumentation/altskripte/design-decisions/ Mon, 01 Jan 0001 00:00:00 +0000 https://ctdi.pages.deinstapel.de/kalibriware/dokumentation/docs/entwicklerdokumentation/altskripte/design-decisions/ Nicht direkt offensichtliche oder triviale Designentscheidungen, welche getroffen wurden, werden im Folgenden dokumentiert. Ausführung der Skripte in Form eines Interpreters in TypeScript Zu Beginn des Projektes wurden verschiedene Ansätze getestet und evaluiert. Der erste Ansatz war eine automatische Transpilierung der Altskripte in das neue Skriptformat. Hierzu sollten die Altskripte geparsed und dann mittels Transformationen des AST (Abstract Syntax Tree) transpiliert werden. Es stellte sich jedoch heraus, dass das automatische Parsen des Bestandes an Altskripten ein aussichtloses Unterfangen ist. https://ctdi.pages.deinstapel.de/kalibriware/dokumentation/docs/entwicklerdokumentation/altskripte/architecture-and-inner-workings/ Mon, 01 Jan 0001 00:00:00 +0000 https://ctdi.pages.deinstapel.de/kalibriware/dokumentation/docs/entwicklerdokumentation/altskripte/architecture-and-inner-workings/ Bis auf wenige Ausnahmen ist der Quellcode für den legacy-interpreter in src/legacy-runtime zu finden. Zeilenbasierte Behandlung von Skripten und Makros Grundsätzlich arbeitet der Interpreter zeilenbasiert, da dies auch die Operationsweise des alten Kalibri-Skript ist. Jede Zeile wird dabei als einzeler Buffer abgebildet. Anbindung an die neue Laufzeitumgebung - legacy-script.ts In der Datei src/script-api/legacy-script.ts wird die Klasse LegacyScriptEngine implementiert. Die LegacyScriptEngine ist ein Wrapper und bindet den Legacy-Interpreter an die neue Laufzeitumgebung an (Ausführung und Fehlerbehandlung).