Sysygy Script Engine - Version 0.99h

[littleDave]

Hallo liebe DP'ler

Ich meld mich mal wieder mit ner neuen Komponente

http://www.godlikesoft.de/images/ext...ngine-Logo.jpg

Einleitung
Nach dem Release meines Sysygy Image Viewers hab ich erstmal eine kleine Pause von dem Projekt gebraucht. Daher hab ich mich dazu entschlossen, meine Script-Engine, die ich bereits in dem Projekt verwende, weiter zu machen und allen zur Verfügung zu stellen.

Allgemeines
Sysygy Script Engine ist eine Skript-Sprache die den Dialekt Pascal benutzt. Es werden bei weitem nicht alle Features der Delphi-Sprache unterstützt, aber immerhin ein kleiner Teil. Beim kompilieren erstellt der Parser Byte-Code, denn dann von einem Interpreter ausgeführt wird.
Durch die Einbindung einer Script-Sprache ist es Möglich, ein Programm von Benutzern erweiterbar zu machen, ohne dass das Hauptprogramm neu kompiliert werden muss. Dadurch wird ein enormes Spektrum an neuen Möglichkeiten eröffnet.
Man kann mit der Script-Sprache z.B. aufwendige, mathematische Funktionen berechnen, die einen einfachen Matheparser überfordern würden. Denn dadurch, dass Ergebnisse in Variablen zwischengespeichert werden können und diese dann mit if-Anweisungen verschieden weiterbearbeitet werden können, kann man z.B. verschachtelte Funktionen erstellen, die nicht an das Programm gebunden sind sondern vom Benutzer während der Laufzeit des Programms geändert werden können (z.B. ein Funktionszeichner).
Ebenfalls ist es möglich, dass sich ein Programm selbst dynamisch anpasst: bei manchen Gelegenheiten ist es extrem schwer, bestimmte Situationen im Code zu verarbeiten. Möglich ist es zwar immer, doch manchmal kann der Aufwand extrem groß sein. An dieser Stelle könnte das Programm z.B. dynamisch neuen Quelltext erstellen, der dann von der Script-Sprache ausgeführt wird.
Sehr hilfreich wird eine Script-Sprache, wenn man z.B. ein Programm per "Fernwartung" erweitern oder ausbessern möchte und man nicht so einfach an die Datei herankommt. Dann kann es z.B. ausreichen, ein neues/verbessertes Script einfach an das Programm zu schicken und somit die Funktionalität erweitern/ausbessern.
Das mag jetzt zwar so klingen, als könnte man ganz einfach in einen PC eindringen - doch man sollte bedenken: das Script kann nur Funktionen ausführen, welche das Programm der ScriptEngine bereits zur Verfügung stellt. (Übertrieben) gesagt kann man nicht aus einer 2 KB-Exe ein Monsterprogramm machen. Ein kleines Beispiel wäre: ich habe eine StringListe, die sortiert werden soll. Die Vergleichsfunktion der einzelnen Zeilen lager ich in ein Script aus, das den Vergleich übernimmt. Das Script kann dann nur die Vergleichsfunktion beeinträchtigen aber z.B. nicht die Liste leeren.

Was unterstützt die Script-Sprache

• Standard-Delphi-Typen: boolean, byte, shortint, word, smallint, integer, cardinal, int64, pointer, single, double, string, record (char kann über byte oder über string gelöst werden)
• Variablen- und Typendeklarationen
• uses-deklarationen
• (natürlich) Kommentare im Script: //, (* *), { }
• procedures und functions mit Parametern (optional auch var-Parameter)
• direkter Aufruf von Delphi-Funktion aus dem Script heraus
• Aufruf von einzelnen Script-Funktionen aus dem Programm heraus
• try-finally und try-except Blöcke
• Byte-Code in Stream speichern und später Ausführen
• for, while und repeat-schleife
• if und case-Anweisung (case auch mit strings)
• Operatoren: and, or, xor, mod, shl, shr, not
• "Klassen" mit Vererbung (wird weiter unten genauer erleutert)
• Compiler-Anweisungen: {$IFDEF} {$IFNDEF} {$ELSE} {$DEFINE} {$UNDEF} {$INCLUDE} {$WARNINGS}
• Lesen und schreiben von Script-variablen aus dem Program heraus
• Code-Vervollständigung von SynEdit
• Call-Stack zur Fehlerfindung aufrufbar

Was wird noch nicht unterstützt
Hier mal eine kurze Liste mit Featuren, die ich noch plane einzubauen:

• 64-Bit-Typen (erledigt mit Version 0.98b) (extended und currency sind nicht geplant)
• arrays
• @ und ^ - Operator (da bin ich mir noch nicht sicher, ob die überhaupt gebraucht werden)
• set und set of - Typen (erledigt mit Version 0.99h)
• try-except und try-finally - Blöcke (kann noch etwas länger dauern) (erledigt mit Version 0.99d)
• einzelne Funktionen im Script aus dem Programm heraus aufrufen (bisher kann nur das komplette Script ausgeführt werden) (erledigt; Feature eingeführt mit Version 0.99b)
• Variablen umcasten (erledigt mit Version 0.99h)
• div-Operator (Divisionen funktionieren schon, aber bitte unter "Enschränkung" nochmal genauer nachlesen) (hat sich erledigt, da "/" jetzt ordentlich funktioniert; letzte Änderung: Version: 0.99a)
• Properties in den Script-Klassen erlauben

Sysygy "Klassen" vs Delphi Klassen
In der Script Engine ist es möglich, externe procedures und functions zu deklarieren. Um diese besser und übersichtlicher zusammenzubringen und den OOP-Gedanken nachzugehen hab ich mich dazu entschlossen, externe Methoden in Klassen zusammenfassen zu können. Dabei unterstützten diese "Pseudo"-Klassen auch Vererbung.
An einem Beispiel kann man das ganz gut erklären:
Nehmen wir an, ich habe in Delphi folgende Komponente, die ich in der Script-Sprache verfügbar machen will:

Delphi-Quellcode:

type
  TMyClass = class(TComponent)
  private
    FSomeThing : string;
  public
    constructor Create(AOwner: TComponent); override;
    destructor Destroy; override;
  
    function GetSomeThing: string;
  end;

Jetzt kann man in der Script-Sprache eine Pseudo-Klasse erstellen, mit deren Hilfe man auf diese Klasse zugreifen kann.
Script-Code

Delphi-Quellcode:

unit myClassUnit;

uses Classes; // für TComponent

type
  TMyClass = class(TComponent)
  public
    function Create(AOwner: TComponent): TMyClass;
    function GetSomeThing;
  end;

Diese Klasse speist man jetzt in einen Exporter, der daraus eine Delphi-Unit erstellt (ist mit dabei). Diese Delphi-Unit bindet man dann in das Delphi-Projekt ein - den Rest übernimmt die Script-Sprache. Ein Script könnte jetzt z.B. so aussehen:

Delphi-Quellcode:

program Test;

uses myClassUnit;

var p: TMyClass;
    s: string;
begin
  p := p.Create; // hier ist ein großer Unterschied zu Delphi
  
  s := p.GetSomeThing;
  if p.ComponentCount = 0 then // da die Klasse von TComponent abgeleitet ist
    exit;
end;

Die Klassen in der Script-Engine sind also sozusaggen nur eine Zusammenfassung von externen Methoden. Es können keine Variablen oder Script-Interne Methoden hinzugefügt werden. Das will ich aber noch ändern, jedoch dauert das eine ganze weile.

Bisherige Einschränkungen

• Man kann zwar schon Unterroutinen in Funktionen schreiben, jedoch kann man in jeder Routine nur auf die routineinternen Parameter, Variablen und auf die globalen Variablen zugreifen. Der Compiler spuckt eine Fehlermeldung aus, wenn man auf Variablen von "Parent"-Funktionen zugreifen will.
• Bisher gibt es den Operator div nicht. Alle Divisionen werden mit dem / ausgeführt. Ob das Ergebniss ein float oder ein Integer ist, hängt dann von den Parametern ab. Wenn man jetzt die Integerdivision 1000 / 3 macht, kommt der Integerwert 333 raus - 1000.0 / 3.0: float-Wert mit 333,33333 usw. (bitte nächsten Punkt auch beachten)
• Da intern sowie extern das Casten von integer auf float noch nicht möglich ist, gibt es eine Funktion "ToFloat(i: integer): single, die Integer-Variablen in eine Float-Variable umwandeln. Dass ist z.B. bei Divisionen mit Variablen, bei denen das Ergebniss ein float sein soll, praktisch. Das werd ich aber auf jeden fall noch ändern. (der Aufruf von "ToFloat" ist ab sofort obsolet)
• Variablennamen und Funktionsnamen können sich [noch] überschneiden, will heißen: man kann noch einer Funktion den gleichen Namen wie einer Variable geben. Beim Aufruf wird man aber immer nur die Funktion bekommen, egal wo die Variable deklariert ist.
• Ein Funktions/Variablen-Name darf nur einmal vorkommen (das ist nicht neu) - dabei werden die Funktionen der per uses eingebundenen Units mitgezählt (neu) - Man kann jede Funktion/Variable nur einmal definieren - aber nur innerhalb einer Unit. In mehrere Units können jetzt die gleichen Funktionsnamen/Variablen sein. Mann greift dann über UnitName.VariablenName drauf zu

So, genug der negativen Sachen

Was muss ich zusätzlich noch an Komponenten installieren?
Die Script-Sprache an sich braucht keine zusätzlichen Komponenten - es werden nur die Klassen benutzt, die bereits bei Delphi mit dabei sind. Auch die mitgelieferten Demos (bis auf eine) kommen mit den Komponenten aus. Jedoch werden für die Kompilierung der Haupt-GUI zwei große Sachen benötigt:

• SynEdit für die Haupt-GUI und für die eine Demo (Code-Vervollständigung-Demo): http://synedit.sourceforge.net/
• JEDI-Component-Library (JVCL) für die Haupt-GUI: http://www.delphi-jedi.org/
• Da ich die TCoolBar und die TToolbar-Komponente in der Haupt-GUI verwende, ist die GUI unter Win95 wahrscheinlich nicht lauffähig (die Script-Engine an sich ist dadurch nicht betroffen). Für diese Komponenten wird die Datei COMCTL32.DLL in der Version 4.70 oder höher benötigt.

Wie installiere ich die Sysygy Script Engine?
Der Parser sowie der Interpretor sind Komponenten mit relativ wenig properties. Von daher ist eine Installation eigentlich nicht vorgesehen. Am besten, ihr kopiert die Quelltexte in einen beliebigen Ordner und fügt diesen in den Suchpfad von Delphi dazu. Ein fertiges Package wird jedoch nicht mitgeliefert.

Welche Delphi-Version muss ich haben?
Also garantieren kann ich für nichts. Ich hab die Script-Sprache mit Delphi 7 erstellt, von daher sollte alles, was neuer als D7 ist, damit klar kommt. Ich weiß nicht, wie weit runter man mit den Delphi-Versionen gehen kann. Jedoch sollte es schon möglich sein, Funktionen als overloaded zu deklarieren.

Sysygy Script Engine + FreePascal
Mit Version 0.99e hab ich es geschafft, die Script-Engine FreePascal-kompatibel zu machen. Ich habe (bis auf ein paar einzelne Scripts) nicht viel ausprobiert, aber es hat alles bisher geklappt. Da ja FPC auf sehr vielen Plattformen funktioniert, weiß ich nicht, ob wirklich alles unterstützt wird. x86-CPUs sollten ziemlich sicher funktionieren, bei x86-64Bit-Systemen weiß ich nicht, ob alles funktioniert.
Die die LCL ja nicht 100%ig kompatibel mit der VCL ist, sind einige Funktionen der Include-Dateien uSygInc*.pas nicht mit eingebunden. Zwar erscheinen diese Funktionen noch im Script, jedoch führt ein Aufruf zu einer Exception. Ich werde aber noch die neuen Includes {$IFDEF FPC} und {$IFDEF DELPHI} in die Header mit einbauen und somit die nicht verfügbaren Funktionen für das Script unsichtbar machen - jedoch dauert das noch etwas.
Bisher gibt es noch Probleme mit den Units uSygIncGraphics und uSygIncWinCRT, die anderen sollten aber funktionieren.

Wie benutze ich die Komponenten?
Ich habe ein paar Demoprogramme in den Download mit hinein gepackt, an denen man (hoffentlich) gut sehen kann, wie man die Komponenten am einfachsten benutzt. Hier ist aber mal der grundlegende Aufbau zur Benutzung

Delphi-Quellcode:

uses
  uSygParser,  // für TSygScript_Parser
  uSygRunTime; // für TSygScript_RunTime

var Compiler : TSygScript_Parser;   // das Objekt muss natürlich vorher erstellt werden
    Executor : TSygScript_RunTime;  // ... und das Objekt sollte auch vorher erstellt werden

function CompileAndExecute(ScriptSource: string): boolean;
begin
  // Ergebniss vorinitalisieren
  result := False;
  // Script kompilieren
  if Compiler.ParseScript(ScriptSource) then
  begin
    // ByteCode im Executor speichern
    Executor.FillData(Compiler.OutputData);
    // Script ausführen
    Executor.Run;
    result := True;
  end;
end;

Was ist in den Download dabei?

• Der komplette Source-Code der Script-Sprache
• 7 Demo-Programme, die die einzelnen Features und ihre Anwendung zeigen
• eine vorkompilierte Version der Haupt-GUI
• ein kleiner Massen-Datei-Umbenenner, der die Script-Engine für die neuen Dateinamen benutzt (als Anwendungsbeispiel)

Lizenz:
Das "Hauptprogramm" sowie die Komponente ist unter der BSD-Lizenz lizenziert. Der Lizenztext liegt ebenfalls nochmal im Hauptordner der zip-Datei sowie als Header in jeder .pas-Datei.
Falls jemand eine andere Lizenz haben will, bin ich gerne bereit, eine einzelne, personengebundene Lizenz nach Absprache zu erstellen.

Und nun ...
... wünsch ich viel Spaß beim ausprobieren und freu mich auf eure Meinungen.

Change-Log

Version: 0.99h (15.10.2008)

• Direkte Type-Casts sind jetzt möglich [z.B. Pointer(cardinal(25) + integer(GetPointer))]
• Enum-Types sind jetzt möglich [z.B. type TTest = (ttEins, ttZwei, ttDrei);]
• OnError-Event in Interpretor geändert: CallStack wird jetzt als Parameter übergeben. Das liegt daran, dass das OnError-Event bei try-finally und try-except Blöcken verzögert ausgegeben wird und dann die Abfrage von CallstackTrack im OnError-Event dann nicht mehr an der wahren OnError-Position ist.
• Kleines Problem mit cardinals behoben
• Problem mit - behoben: es musste immer ein Leerzeichen vor einem Minus sein, wenn eine Zahl angegeben wurde, sonst gab es eine Fehlermeldung
• Constanten können jetzt auch ein - haben
• Identifier-Expression verbessert/ausgebaut:
• TKlasse(Identifier).Funktion funktioniert jetzt
• Unitname.Variablenname sowie Unitname.Funktionsname funktioniert jetzt
• Es können jetzt mehrere Variablen/Funktionen den gleichen Namen haben - solange sie in verschiedenen Units deklariert sind. Über UnitName.Identifier kann dann auf die verschiedenen Variablen/Funktionen zugegriffen werden
• Fehler im not-Operator behoben: der Operator hatte die falsche Priorität
• Fehler in Operatoren "*/ mod and shr shl" behoben
• Fehler in Vergleichsoperatoren behoben: komplexere Vergleiche ohne genügend Klammern lieferten ein falsches Ergebniss
• Fehler in Vergleichsoperatoren behoben: grundlegende Vergleiche funktionierten zwar, jedoch konnte es passieren, dass das Negieren von Vergleichen nicht funktionierten
• RunTimerOnError-Event: Parameter verändert

Version: 0.99g (06.08.2008)

• Kleiner Fehler im Parser: int64-Typen wurden nicht zu int32-Typen umgewandelt, falls erforderlich
• Code-Completion-Display etwas verbessert
• Geschwindigkeit von TSygScript_RunTime.LoadFromStream extrem verbessert
• Memory-Leak im Parser behoben
• ein paar kleine Probleme mit Records behoben
• manche Variablen wurden bei verschachtelten Funktionen ungültig

Version: 0.99f (24.07.2008)

• Im Interpretor kann man jetzt mit Hilfe von Properties schnell Script-Variablen abrufen bzw. ändern
• Die Angabe der Unit beim Registrieren von Methoden bzw. beim Lesen von Variablen ist jetzt optional. Es kann auch einfach ein Leerstring übergeben werden - dann wird die erste Variable genommen, die den gesuchten Namen hat
• Das Script wurde beim Aufruf von Run nochmals intialsiert, obwohl "InitializeRun" bereits aufgerufen wurde
• Kompiliergeschwindigkeit verdoppelt. Das kompilieren von langen Scripts mit vielen uses-Units dauert jetzt nicht mehr so lange
• Fehler bei exit-Anweisung in verschachtelten try-finally-Blöcken behoben -> es wurde nur die letzte finally-Anweisung aufgerufen
• Die Continue-Anweisung funktioniert jetzt auch in while und repeat - Schleifen korrekt
• Kleiner Memory-Leak entfernt
• Kritischer Fehler im Parser und im Interpretor behoben: beim Aufruf von tieferen Unterlementen (z.B. Application.MainForm.Caption - Application.MainForm an sich funktionierte bereits) wurden Variablen im Script-Stack überschrieben.
• Schwerer Fehler mit der Script-String-List behoben. Bei bestimmten Unit-Konsterlationen wurden die falschen Strings im Script verwendet

Version: 0.99e (18.07.2008)

• ScriptEngine mit Lazarus kompilierbar
• Zwei neue Script-Compiler-Defines: {$IFDEF FPC} wenn Lazarus/FPC benutzt wird und {$IFDEF DELPHI} wenn Delphi benutzt wird
• Einige Funktionen der VCL gibt es in der LCL nicht, daher sind diese auch nicht in der Script-Engine verfügbar. Die Klassen behinhalten zwar auch diese Funktionen, beim Aufruf wird aber eine Exception ausgelöst, wenn die entsprechende Funktion unter Lazarus nicht verfügbar ist.
• Der Aufruf von Script-Funktionen aus dem Programm heraus funktioniert jetzt auch, wenn das Script währenddessen schon läuft
• Die Parameter von TSygScript_Parser.FindFunction, TSygScript_Parser.Call abgeändert
• var-Parameter beim Aufruf von Script-Funktionen aus dem Programm heraus funktioniert jetzt. Dabei muss beim Aufruf einfach ein Pointer auf die Variable übergeben werden
• In der Unit WinCRT können jetzt Events registriert werden. Ein Demo-Script ("EventTestProgram.scs") für die Verwendung ist mit dabei
• Das Beispielscript "TimeInformation.scs" etwas überarbeitet

Version: 0.99d (16.07.2008)

• try-finally und try-except-Blöcke eingeführt
• Neue Funktion in der System-Unit: RaiseException(msg: string);
• Neue Funktion in der System-Unit: Assert(Condition: boolean; msg: string);
• Neues Beispiel-Script für das Hauptprogramm: "ClearTempData" (löscht alle, für ein Source-Release unrelevanten, Dateien, die von Delphi erstellt wurden)
• Resourcen-Schutz-Blöcke (try-finally) in die anderen Demo-Programme eingefügt
• Windows-uses aus den Units entfernt, die die "Windows.pas" nicht benutzen. Falls die Windows.pas benutzt werden muss, wird diese per {$IFDEF WIN32} eingebunden
• CopyMemory ersetzt durch "System.Move"
• Alte Debug-Anweisungen im Parser gelöscht
• Fehlermeldungen des Compilers in const-strings ausgelagert und etwas überarbeitet

Version: 0.99c (12.07.2008)

• Kleiner Fehler im Parser und im Interpretor behoben: LoadFromStream/SaveToStream hat eine Untermethode aufgerufen, die fehlerhaften Code drinnen hatte
• Demo 4: Quelltext der Demo war noch nicht auf die neuen UnitNamen aus Version 0.99b umgestellt

Version: 0.99b (10.07.2008)

• In dieser Version haben sich einige externen Sachen (z.B. Funktionsnamen, Unitnamen, ...) geändert! Daher ist ein Update auf diese Version mit etwas Aufwand verbunden! Natürlich versuche ich solche groben Änderungen nicht zu machen; doch machmal hab ich keine andere Wahl.
• Hauptprogramm: Toolbar eingebaut
• Sinnvollere Unit-Namen vergeben
• Einige Komponenten und Funktionen umbenannt
• Aufbau vom Interpretor etwas verändert
• Fehler im Interpretor im Operator disc behoben
• Einzelne Script-Funktionen jetzt aufrufbar
• Fehler bei Doubles in Records behoben
• Größe des ByteCode-Streams verringert
• Fehler in Records behoben: beim Aufruf von externen Funktionen, die ein Record mit einer String-Variable als Parameter hatten, wurde zu wenig Speicherplatz benutzt und es gab eine Exception
• Fehler in Records behoben: beim Aufruf von externen Funktionen, die ein Record mit einer Single-Variable als Parameter hatten, wurde zu viel Speicherplatz benutzt und die Daten wurden ungültig
• Code-Completion setzt die Property "GenerateCode" jetzt automatisch wieder zurück
• Es gibt jetzt eine overloaded-procedure von ParseScript, bei der man den Script-Quelltext als Parameter mitliefern kann
• TPoint und TRect in die Unit "System" verschoben
• drei neue Script-Unit hinzugefügt: Forms, Menus, StdCtrls (weitere werden noch folgen)
• Fehler in der uses-Deklaration behoben: identifiers aus weiteren uses-Units wurden nicht gefunden
• Neue Demo hinzugefügt: Diese Demo zeigt, wie man einzelne Script-Funktionen aus dem Programm heraus aufruft
• Neue overloaded-function im Interpretor: CallStackTrace kann jetzt auch ohne StringList ausgeführt werden. Der Inhalt der StringList (inc. Zeilenumbrüche) wird dann als Strings-Result-Wert zurückgegeben

Version: 0.99a (03.07.2008)

• Code-Minimierung eingeführt: die Code-Minimierung reduziert den erstellen Byte-Code, in dem er unbenutzte Stellen löscht
• Call-Stack jetzt erstellbar (zum Debuggen)
• Kleiner Fehler im RunTime-Stack behoben (Ausführung wurde nicht beeinträchtigt)
• Hauptprogramm: Export-Funktion durch Ausnutzung von neuen Features sehr viel schneller gemacht
• Hauptprogramm: InstructionList-Viewer erweitert
• Neue Script-Demo für das Hauptprogramm: TimeInformation.scs
• Kleiner Fehler in der Code-Completion behoben
• Konstanten werden nicht mehr im Stack gespeichert
• Doppelte Einträge in der Runtime-StringList werden jetzt vermieden
• kleiner Fehler im automatischen Type-Cast behoben: integer -> float wurde zu spät ausgeführt -> starke Rundungsfehler
• ehemalige Debug-NOOPs im Code entfernt

Version: 0.99 (23.06.2008)

• kleiner Operator-Fehler im Interpretor beseitigt
• ToFloat ist jetzt endlich obsolet
• Return-Address-Typ geändert (ist für einen Stack-Trace wichtig, den ich später einbauen werde)
• Neues Demoprogramm: ein Massen-Datei-Umbenenner, der den neuen Dateinamen anhand eines Scripts erstellt
• Neue Funktion: "InitializeRun" in "TSygScript_RunTime": muss aufgerufen werden, wenn das Script mehrmals verwendet werden soll, ohne dass der ByteCode neu geladen werden soll (die Verwendung wird im neuen Demo-Programm gezeigt)
• Formatierung in der Code-Completion verändert
• kleinerer Download da die Demos nun nicht mehr vorkompiliert sind
• ein paar kleine Bugs behoben

Version: 0.98b (18.06.2008)

• 64-Bit-Typen hinzugefügt (int64, double)
• TDateTime auf double geändert
• Neue Funktionen in SysUtils: DiscSpace, DiscFree, FileSize
• Viele Funktionen auf int64 bzw double geändert
• Automatisches casten zwischen den Variablen (ToFloat sollte immer noch verwendet werden)
• Viele Bugs beim Ausführen von Delphi-Methoden behoben (viele waren mit single-Typen)
• GetVariable und SetVariable im Interpretor können nun auch mit double/int64 umgehen
• extended aus der Typendeklaration entfert (sorgt sonst nur für Verwirrung)
• rtlVclOptimize herausgenommen
• Geschwindigkeit des Stacks erhöht
• fehlende Funktion im Release-Paket hinzugefügt (hat anscheindend noch niemand gemerkt)

Version: 0.98a (13.06.2008)

• Initial release

[littleDave]

Es gibt mal wieder was neues zu berichten: eine neue Version ist wiedermal online (auch wenn das hier langsam zum Tagebuch wird, sind doch ein paar Neuerungen mit drinnen )

Die Script-Engine ist jetzt auch unter FPC kompilierbar . Zu den Einschränkungen gibt es im ersten Post einen neuen Abschnitt Sysygy Script Engine + FreePascal
Außerdem ist jetzt nun möglich, Parameter als var-Parameter im Script-Funktionsaufruf aus dem Programm heraus zu benutzen. Dafür muss in dem array of const einfach der Pointer auf die Variable übergeben werden, den Rest macht die Script-Engine selber.

Den Download sowie den aktuellen ChangeLog gibts im ersten Post

Grüße
Dave

[littleDave]

Servus miteinander,

ich hab mal wieder eine neue Version hochgeladen - diesmal ohne viel Neuerungen - aber dafür mit vielen Bug-Fixes:

Der erste wichtige Fehler war eine fehlerhafte Behandlung von Exit-Anweisungen in verschachtelten try-finally-Blöcken. Wenn im tiefsten try-finally-Block die Funktion "exit" aufgerufen wurde, sprang das Programm nicht durch alle finally-Anweisungen sondern nur in den letzten finally-Block - das ist jetzt behoben

Dann hab ich mich weiter mit den try-Blöcken beschäftigt und bin auf einen schon sehr alten Fehler gestoßen: Wenn in einer repeat-until oder in einer while do-schleife die Anweisung "continue" aufgerufen wurde, hat sich das Script sofort beendet - ohne Fehlermeldung. Das ist jetzt behoben, die continue-Anweisung funktioniert jetzt auch in while/repeat Schleifen.

Dann ist mir noch ein sehr kritischer Fehler aufgefallen: bei verschachtelten Element-Aufrufen mit mehr als einer Ebene (also z.B. Application.MainForm.Caption) wurden Variablen im Script-Stack überschrieben. Das passierte aber nur, wenn die zuletzt aufgerufene Methode eine procedure und keine function ist.
In diesem Zusammenhang ist mir gleich noch ein kleiner Fehler in einer Anweisung im Interpretor aufgefallen, die ich natürlich ebenfalls sofort behoben habe

Da ich in Version 0.99a die Script-String-Liste, die die einzelnen Strings des Scripts beinhaltet, verbessert habe, kam ein Fehler zum Vorschein, der vorher nicht aufgetreten ist: Die Auswahl des Strings in uses-Units wurde nicht korrekt ausgeführt. Somit war die String-Ausgabe fehlerhaft. Das ist jetzt auch behoben.

So, das wars auch schon wieder - ach ja: Download und ChangeLog ist im ersten Post zu finden

Grüße
Dave

[littleDave]

Juhu, der 4. Post hintereinander

Es gibt mal wieder was neues zu Berichten. Es hat diesmal zwar nur indirekt mit der Script-Engine zu tun, aber doch ein wenig.

Um die Script-Engine an sich besser testen zu können, hab ich ein "kleines" Test-Projekt geschrieben, dass die Script-Engine sehr intensiv benutzt: Es ist ein HTTP-Server, bei dem die Seiteninhalte, wie z.B. mit php, dynamisch erstellt werden. Den dynamischen Part übernimmt dabei komplett die Script-Engine.
Die Seite an sich ist ein "Multi-Blogger", d.h. es ist ein Server, bei dem jeder Benutzer einen eigenen Blog erstellen können. Jeder Blog kann dabei beliebig viele Kategorien haben. Diese Kategorien werden dann nochmal in Unterkategorien unterteilt, in denen dann die einzelnen Posts hineingeschrieben werden.
Der Server speichert dabei seine Daten in eine selbst geschriebene Datenbank, die ich mal geschrieben hatte.

Ich bin mir noch nicht sicher, in welcher Form ich das Projekt freigeben will (Freeware oder OpenSource).

Der eigendliche Grund dieses Posts ist, dass der Server im Moment online ist und frei benutzt werden kann. Für alle, die nicht extra einen Account anlegen wollen (ohne Account nix los), hab ich einen Gast-Account erstellt. Benutzername und Passwort ist jeweils gast (Passwort muss klein geschrieben werden).

Falls ihr euch traut, euch zu registrieren - euer Passwort wird als MD5 in der Datenbank gespeichert. Außerdem werde ich die Datenbank sowieso irgendwann löschen. Wer mir traut (muss ja nicht euer Root-Passwort sein ), kann sich ja registrieren - für die Anderen ist der Gast-Account da. Wäre schön, wenn sich der ein oder andere mal 5 min die Zeit nimmt und sich das anschaut.
Ach ja, natürlich könnt ihr auch euren Eigenen Test-Blog erstellen, Beiträge kommentieren usw - auch mit dem Gast-Account.

Was ich gerne von euch wissen würde, ist: Besteht interesse an dem Programm? Sind Fehler vorhanden?

Hier die URL: http://littledave.globedns.info
Der Server ist heute bis ca. 23:00 Uhr online, dann das ganze Wochenende erstmal nicht, dann ab nächste Woche wieder tagsüber.

[ConstantGardener]

Hallo LittleDave,

also ich hab mir den MultiBlogger mal kurz angeschaut und finde das System und Design echt nett.

Ist wirklich ganz interessant. Wie hast Du das ganze aufgebaut (Welcher Server, Hoster etc. pp) ??

grüsse

ConstantGardener

[littleDave]

Der Server ist ein einfacher idHTTPServer. Der Request wird dann an die Script-Engine übergeben, die dann daraus den Inhalt der Seite erstellt. Wenn die Script-Engine fertig ist, ist der Inhalt der HTTP-Seite in einem String, der dann wieder vom HTTP-Server ausgelesen und danach gesendet wird.

Das Design ist nicht von mir, ist ein Freeware-Template (Link steht auf der Seite ganz unten rechts)

Der Server läuft hier lokal auf meinen Rechner. Die IP-Addresse wird über globedns.info bekanntgegeben.

Was bei diesem Projekt auch noch sehr wichtig für mich war, ist die Performance. Die Website wird meistens innerhalb von 2-5 Millisekunden erstellt, wobei die Script-Engine dabei ca. 1.000 bis 5.000 Zeilen Script-Quelltext abackert.

Hier ist mal der grobe Ablauf eines Requests:
- der idHTTP-Server parsed den Header aus HTTP und übergibt ihn an die Anwendung
- Anhand des Document-Request wird die Script-Datei ausgewählt, die die Seite erstellen soll
- Die Request-Parameter werder dann an den Script-Interpretor übergeben
- Das Script wird ausgeführt
- Das Ergebniss des Scripts wird wieder ausgelesen und an den idHTTP-Server übergeben
- der idHTTP-Server sendet dann die Daten

In einem Script kann natürlich komplett auf die eingebaute Datenbank zugegriffen werden, Such-Queries gestartet und ausgewertet werden und Einträge verändert werden.

Der Server an sich kann nur "Script auswählen - Daten übergeben und wieder auslesen - Senden". Den Rest übernimmt die Script-Engine.

[littleDave]

Da ich im Moment die Script-Engine ausführlich in meinem "Testprojekt" Multi-Blogger ausprobiere, finde ich ab und zu auch noch ein paar Fehler - daher hab ich jetzt mal wieder eine neue Version hochgeladen. Erstmal ich die Geschwindigkeit der Routine "TSygScript_RunTime.LoadFromStream" extrem verbessert. Dies ist besonders bei langen Scripts bemerkbar (bei meinem Projekt hat ein Script ca. 20.000 Instructions, diese werden jetzt innerhalb von wenigen Millisekunden geladen - ohne die Optimierung waren es ca. 1-2 Sekunden).
Zum anderen ist mir ein Memory-Leak im Parser aufgefallen, den ich sofort behoben habe.

Da ich in mein "Testprojekt" (ein HTTP-Server, der die einzelnen Seiten mit Hilfe dieser Script-Engine erstellt) schon sehr viel Arbeit hineingesteckt habe, wollt ich es eigentlich auch noch veröffentlichen. Im Moment komm ich ganz gut vorran und es ist auch schon fast alles lauffähig. Doch ein paar Sachen fehlen noch. Falls sich jemand bereits jetzt dafür interessiert, kann er sich

hier (http://littledave.globedns.info)

schonmal alles anschauen und etwas herumspielen (der Gastaccount, den ich in Post #43 vorgestellt habe, existiert nicht mehr, da nun einiges auch ohne Account möglich ist)

[littleDave]

Man ist der letzte Update lange her. Aber die Entwicklung hat währenddessen nicht geschlafen, sie war nur langsamer. Jedenfalls hab ich mal wieder die aktuellste Version hochgeladen in der sich einige Veränderungen und Verbesserungen befinden.

An alle, die noch nicht so ganz wissen, wozu diese Script-Engine gut ist: ich habe bereits folgende Projekte damit realisiert:

• Desktop Widget Engine (aktuellstes Projekt, nutzt die Script-Engine intensiv)
• Multi Blogger HTTP Server (mein Testprojekt für diese Script-Engine)
• Sysygy Image Viewer (ich hab die Script-Engine eigendlich für dieses Projekt erstellt, jedoch befindet sich in diesem Programm eine Uralt-Version)

Download ist im ersten Post zu finden

[EugenB]

Moin,

irgendwie bin ich grade im Script-Wahn , zuerst hab ich Pascal Script probiert aber irgendwie sind da noch soviele Fehler, dann hab ich schon fast vergessen das es diese Script Engine noch gibt

Da ich FPC nutze, musste ich in dieser Datei: uSygConstants

diesen Teil:

Delphi-Quellcode:

procedure TSygScript_List.SetCount(value: Cardinal);
var i: integer;
begin
  for i:=Count to value-1 do
    Add(nil);
end;

auch unter das {$IFNDEF FPC} packen

dann konnte ich es schon mal Compilieren

Da es noch keine Arrays gibt haste wohl diese TIntegerList hinzugefügt oder? ist ganz hilfreich, jedoch wie kann man die Werte neu setzen? ich fand dazu keine Funktion, also hab ich diese mal eben hinzugefügt:

Delphi-Quellcode:

procedure TIntegerList_SetItem(Self: TIntegerList; index: integer; Item: Integer);
begin
  Self.Items[index] := Item;
end;

das selbe auch für TFloatList

Deine Script Engine ist eine richtige Alternative zum Pascal Script.

Was meinste wann diese Sachen funktionieren werden?
Arrays
Class Properties
Gleichnamige Funktionen ( welcher aber verschiedene Parameter haben zB. x(a: Integer); x(a: Float); x(a,b : Integer); etc

Wie füge ich Funktionen hinzu, auch wenn ich den UnitName nicht weiß?

Delphi-Quellcode:

procedure TForm1.ParserOnAddCustomFunctions(Sender: TObject; UnitName: string);
begin
   if(UnitName='myprogram')then
   begin
      TSygScript_Parser(Sender).AddFunction(@MyWriteLn, 'procedure WriteLn(s: string); register;');
   end;
end;

Wenn ich das ohne UnitName='my...' mache bekomme ich nen Fehler das WriteLn schon existiert, gibt es vllt ne Funktion zum zu gucken ob diese Funktion schon existiert? oder wie löst man es am besten.

Ich finde diese Engine besser als das Pascal Script, auch wenn die obigen Wünsche noch(?^^) nicht implementiert sind, zB Array ist bei Pascal Script vorhanden, jedoch gibts damit noch probleme, Class Properties funktionieren jedoch nur bei Variablen also vom Programm her hinzugefügte, jedoch kann man in Pascal Script keine Klassen im Script erstellen, wieder ein Pluspunkt , Gleichnamige Funktionen gibt es auch unter PS nicht, und Funktionen mit zB. Parameter mit gleichen Typen werden richtig aufgerufen

Ich würde vorschlagen das du die Scipt Engine auf einen SVN Server packst, dann könnte man immer nen aktuellen Code bekommen und man könnte leichter Patches erstellen

Weiter so

[mschnell]

Hi Dave,

Hast Du Deinen Bytecode komplett neu erfunden, oder hast Du eine Vorlage benutzt ?

Gibt es eine Beschreibung für den Bytecode ?

(Ich möchte u.U,. den Bytecode-Interpreter in C implementieren, um auf einem Prozessor, für den es keinen Object-Pascal-Compiler gibt, Delphi-Code laufen zu lassen. )

Gruß und Dank,

-Michael

[EugenB]

Ich bins mal wieder xD

Wie kann ich dem Script eine vorhandene Variable / Klasse zuweisen? zb. Self:TForm ?