[Release] AAL, an Open-Source AutoIt Alternative

Page 1 of 3

12/10/2015 21:03 Shadow992#1

Heyho together,

in this thread I want to finally present my created programming language called AAL (=Advanced Automation Language), an Autoit-Alternative.

You also may have a look at Warfleys AAL-Editor: [Only registered and activated users can see links. Click Here To Register...]

GitHub-Link: [Only registered and activated users can see links. Click Here To Register...]

German

Spoiler

English

Spoiler

This is not a 1:1 translation, but a rough summary of the german version (1:1 translation is in work):

What is AAL?
AAL tries to give the possibility to do basic and also complex automation tasks based on an easy syntax and semantic.
So AAL tries not to be as similar to AutoIt as possible but tries to get the best out of AutoIt and mix it with things that are kind a missing or done worse in AutoIt, e.g.:

Quote:

- Missing class support (only possible with UDF and then still quite strange to use)
- Quite slow
- Very Easy to decompile and nearly impossible to break existing decompilers
- No possibility to use real multithreading
- Missing or very complicated hardware near programming (e.g. complicated pointer and structs)
- Sometimes strange behaviour and inconsistent keywords (e.g. "While" and "WEnd" but "If" and "EndIf" or "For" and "Next").
- Kind of missing inline ASM
- Missing possibility to compile as DLL

AAL is open-source and I will try to keep it as long open-source as possible.
So you can lear from the project. That is also why I tried to document many things as good as possible.
You should not only learn from this project, but I am also happy to see people helping together to reach the goal of "being a mighty AutoIt alternative".
You do not only have to be familar with coding, I am searching for all kind of help, e.g.:

Quote:

- I am always happy to see guys helping me finding bugs/errors/strange things. So if you want to help me not just with some short texts/functions, you can write me an email and I will help you getting familiar with code. I will not explain fundamental C/C++ things (so I will not act as a kind of teacher/tutor but will help to answer all unclear codes and explain the basic ideas of the algorithms)
- If you are having not enough time to work regulary at the project but you still want to contribute, you can also send me some pieces of C/C++ code (e.g. PictureSearch-Algorithms, faster implementation of existing functions, ...) and I will add them on occasion.
- If cou can not program C/C++ at all, you can also help to write new functions by using AAL-Code (this of course is, especially in alpha stage, a risky method because if something does not work, you can not be sure if it is your code or the AAL-Interpreter/Compiler).
- You can also help by finding bugs/making suggestions.
- If you are not able to program at all (neither C/C++ nor AutoIt/AAL), you can still help by finding undocumented functions/writing mistakes/bad english.
- Another possibility to help is by translating english texts into other languages (esepcially into german).
- Last but not least, I am also looking for a website and a website layout. I would be able to do it by myself (and I guess I will do the backend by myself) but I really hate HTML/CSS/JS.

What do I have to take care of when using AAL in alpha stage?

Quote:

The compiler is not able to detect all kind of errors. It only can detect some basic errors in Code (around 60%).
So it is possible to write a code where the compiler is not complaining at all, but the Interpreter still crashes because the compiled Code is not valid. This means whenever you think there is a bug, you have to double check if really every line of your code is correct.
This will be fixed in some feature versions but for alpha stage we have to live with this.

What else to know?

Quote:

There are 2 versions of AAL, a Debug version and a Realease version.
The Debug-Version will write some information to the file "compiler.debug.txt" and "interpreter.debug.txt".
So whenever you think you found a bug or you want to understand what is going on, use the debug version.
The debug version is of course much slower than the release version, but helps to debug the generated code.

Documentation files (all files can be reached by using the CompileAndRun.exe file):

Quote:

./Getting Started/aal_functions.html - This file gives an overview of already implemented AAL standard functions and their arguments (english)
./Getting Started/aal-developer-manual.pdf - This file will help to understand what is happening inside AAL-Compiler/Interpreter (only german at the moment)
./Sourcecode-Doc/index.html - This file is the main file of doxygen documentation for C/C++ Sourcecode (english)

Getting Started:

Quote:

Just start "CompileAndRun.exe", then click on the button "Select file" and select the file you wrote (or navigate to Examples folder and select an example file). After that press "Run Debug" or "Run Release" (whatever you want to do). The first showing window is the compiler and the second window the interpreter. If you want to see the output of interpreter/compiler just have a look at e.g. "interpreter.release.txt"

zLib License:

Spoiler

This means, to sum up:
Use it for whatever you want, but do not hide the real author(s).

Changelog:

Planned Features for next Version

Spoiler

Known Bugs

I hope to find many people who are interested in this project and want to help me. Thanks in advance for all kind of help! :)

12/11/2015 06:57 Tasiro#2

Gut gemacht! Wo ist der GitHub-Link?

12/11/2015 08:14 Strew#3

Erstmal vor weg, ich bin sehr begeistert von der Projekt Idee.
Ich habe zwar noch kleine Zweifel wie das ganze weitergehen soll,
aber ich bin da relativ offen und werde dich definitiv dabei unterst�tzen
wenn du m�chtest. Wie und in welcher Form muss ich mir allerdings noch
�berlegen, da k�nnte man dann ja aber auch via PN dr�ber quatschen.

Nat�rlich w�nsche ich dir viel Erfolg damit und dr�cke dir die Daumen.

Liebe Gr��e, Strew

12/11/2015 11:15 Shadow992#4

Quote:

Originally Posted by Tasiro

Gut gemacht! Wo ist der GitHub-Link?

Der kommt in der n�chsten Version (sprich 0.0.2alpha).

Quote:

Originally Posted by Strew

Erstmal vor weg, ich bin sehr begeistert von der Projekt Idee.
Ich habe zwar noch kleine Zweifel wie das ganze weitergehen soll,
aber ich bin da relativ offen und werde dich definitiv dabei unterst�tzen
wenn du m�chtest. Wie und in welcher Form muss ich mir allerdings noch
�berlegen, da k�nnte man dann ja aber auch via PN dr�ber quatschen.

Nat�rlich w�nsche ich dir viel Erfolg damit und dr�cke dir die Daumen.

Liebe Gr��e, Strew

Ich freue mich �ber jegliche Hilfe, egal in welcher Form und wenns nur psychisch ist. :D

Wer will kann mich ja unter Skype hinzuf�gen (wundert euch nicht �ber den Namen ist ein uralter Account und war ein Insider damals :D):

Stalaktiten

12/12/2015 12:54 [Beatrice]#5

Great. I guess it'd be awesome to add an editor. Also to make DllCalls. Keep it up :p

12/12/2015 16:39 Shadow992#6

Quote:

Originally Posted by [Beatrice]

Great. I guess it'd be awesome to add an editor. Also to make DllCalls. Keep it up :p

Yep this will also come when the basic functions are working without any bugs. :D
But until then it is a long way.

12/12/2015 18:09 Else#7

Der Schritt zur eigenen Sprache ist getan. Hut ab! :-)

12/13/2015 22:41 alpines#8

Sehr sch�n, wird interessant das ganze mitzuverfolgen.

12/14/2015 01:13 Moneypulation#9

Daumen hoch. Gibts einen weg das Bild von CaptureWindowByName() zu sehen bzw. es zu speichern? Und kriegst du es hin, dass man den WindowHandle den man als Parameter braucht, in eine Variable zu speichern, da sich der Titel ja �ndern k�nnte. Au�erdem wie siehts mit einer GUI aus?

12/14/2015 16:47 Shadow992#10

Quote:

Originally Posted by Moneypulation

Daumen hoch. Gibts einen weg das Bild von CaptureWindowByName() zu sehen bzw. es zu speichern? Und kriegst du es hin, dass man den WindowHandle den man als Parameter braucht, in eine Variable zu speichern, da sich der Titel ja �ndern k�nnte. Au�erdem wie siehts mit einer GUI aus?

- Bild speichern kommt in der naechsten Version (0.0.2 alpha)

- WindowHandle speichern kommt ebenfalls in der naechsten Version (nur momentan gibt es ja noch keine Moeglichkeit ueberhaupt dieses Handle zu benutzen, deswegen gibt es momentan noch keiner derartige Moeglichkeit) :D

- GUI wird noch ein gutes Stueck dauern. Vielleicht fuege ich ganz simple und billige Controls schon in der naechsten oder uebernaechsten Version hinzu (sprich Window, Button und Inputbox). Fuer GUI-Programmierung braucht es aber tatsaechlich noch viel ausenrum, wo ich noch nicht sicher bin ob es "einfach so klappt".

12/26/2015 15:34 Shadow992#11

This time I want to release the second alpha version of AAL.
I did not expect to find that few bugs, but I actually only found 2 big bugs.
So the new version focused on new features and updating/expanding documentation. However I just did little work on documentation.

Changelog:

Spoiler

New version was added to first post (0.0.2alpha).

For the next version I plan to focus on optimizing generated ByteCode.
This can speed up the complete execution time alot.

12/26/2015 18:18 warfley#12

Wann kommt die M�glichkeit andere Dateien zu includen? Habe grade mit einem kleinen Formeditor angefangen, und ich muss sagen es w�re deutlich sch�ner wenn man den Formcode einfach in eine separate Datei auslagern k�nnte.

PS: Habe die neuen Funktionen jetzt im Editor, aber dabei ist mir aufgefallen dass du bei vielen Funktionen im Summary immer noch die Funktion CaptureWindowByName angibst,

12/26/2015 18:27 Shadow992#13

Quote:

Originally Posted by warfley

Wann kommt die M�glichkeit andere Dateien zu includen? Habe grade mit einem kleinen Formeditor angefangen, und ich muss sagen es w�re deutlich sch�ner wenn man den Formcode einfach in eine separate Datei auslagern k�nnte.

PS: Habe die neuen Funktionen jetzt im Editor, aber dabei ist mir aufgefallen dass du bei vielen Funktionen im Summary immer noch die Funktion CaptureWindowByName angibst,

Inoffiziell gibt es die M�glichkeit schon.
Also eine include-Direktive gibt es bereits und sie sollte auch einigerma�en funktionieren.
Momentan gibt es noch zwei kleine "Unsch�nheiten" an dem Ganzen:

- Da das Kompilieren der Dateien noch etwas "umst�ndlich" passiert, muss man h�chstwahrscheinlich die zu inkludierenden Dateien auch in das "bin" Verzeichnis verschieben.
- Die Funktion wurde bisher nur einmal ganz am Anfang getestet, ich wei� also nicht wie es momentan aussieht und ob sie �berhaupt l�uft.

Aber prinzipiell ist sie benutzbar, indem man folgendes schreibt:

Code:

#include("file_to_include.aal1")

Ich werde mir das morgen und �bermorgen mal genauer anschauen und dabei auch die Dokumentation noch anpassen. Zus�tzlich werde ich auch das Kompilieren endlich "sinnvoller" und intuitiver machen (mit Flags u.�.).
Sp�testens Montag wird also die Include-Direktive definitiv unterst�tzt.

12/26/2015 19:26 warfley#14

Quote:
Originally Posted by Shadow992
Inoffiziell gibt es die M�glichkeit schon.
Also eine include-Direktive gibt es bereits und sie sollte auch einigerma�en funktionieren.
Momentan gibt es noch zwei kleine "Unsch�nheiten" an dem Ganzen:

- Da das Kompilieren der Dateien noch etwas "umst�ndlich" passiert, muss man h�chstwahrscheinlich die zu inkludierenden Dateien auch in das "bin" Verzeichnis verschieben.
- Die Funktion wurde bisher nur einmal ganz am Anfang getestet, ich wei� also nicht wie es momentan aussieht und ob sie �berhaupt l�uft.

Aber prinzipiell ist sie benutzbar, indem man folgendes schreibt:
Code:
#include("file_to_include.aal1")
Ich werde mir das morgen und �bermorgen mal genauer anschauen und dabei auch die Dokumentation noch anpassen. Zus�tzlich werde ich auch das Kompilieren endlich "sinnvoller" und intuitiver machen (mit Flags u.�.).
Sp�testens Montag wird also die Include-Direktive definitiv unterst�tzt.

Nice dann werde ich das mal implementieren. Damit kann ich auch schon das Projekt System anfangen
Ich h�tte dann noch eine Frage, wie funktioniert das mit cirkul�ren Referenzen also wenn ich die forms in einer separaten Datei A erstelle, und diese dann in B include funktioniert es dass ich sowohl �ber die Datei B die Variablen von a verwende aber in A die Funktionen von B als Event setze, wie muss ich die includes setzen?

12/26/2015 19:52 Shadow992#15

Quote:

Originally Posted by warfley

Nice dann werde ich das mal implementieren. Damit kann ich auch schon das Projekt System anfangen
Ich h�tte dann noch eine Frage, wie funktioniert das mit cirkul�ren Referenzen also wenn ich die forms in einer separaten Datei A erstelle, und diese dann in B include funktioniert es dass ich sowohl �ber die Datei B die Variablen von a verwende aber in A die Funktionen von B als Event setze, wie muss ich die includes setzen?

Alles was das Include macht ist die Anweisung durch den Inhalt der Datei zu ersetzen. Wenn man Die Includes zirkul�r definiert, also in etwa so:

File1.aal1

Code:

#include("File2.aal1")

File2.aal1

Code:

#include("File1.aal1")

Wird der Compiler in eine endlos Rekursion �bergehen.
Um das mehrmalige Einbinden (und damit solche Fehler zu beheben/unterdr�cken) zu verhindern, gibt es die Direktive "#include-once".
Aber auch das wurde logischerweise (wie das #include) nur einmal am Anfang getestet.
Das hei�t der funktionierende Code s�he so aus:

File1.aal1

Code:

#include-once
#include("File2.aal1")

File2.aal1

Code:

#include-once
#include("File1.aal1")

Ansonsten gibt es keinerlei Probleme bei bisher undefinierten Funktionen o.�.
Dynamische Sachen (also so etwas wie onEvent, was auch zur Laufzeit zusammengebastelt werden k�nnte), werden erst zur Laufzeit validiert und wenn der Interpreter zur Laufzeit eine Funktion nicht aufl�sen kann kracht es. Wenn das jedoch zur Compile-Zeit passiert gibt es maximal eine Warnung (wobei selbst das momentan noch nicht implementiert ist, also momentan wird der Compiler �berhaupt nicht meckern).
Auch die Reihenfolge der Funktionen u.�. ist egal.

Auf gut deutsch:
Wenn es kracht, dann nur zur Laufzeit, der Compiler geht also davon aus, dass du richtigen Code (zumindest was den dynamischen Teil angeht) schreibst. Das Verhalten soll auch so bleiben (eventuell wird es an einigen Stellen Warnings geben, aber Errors werden es nie). Sind Variablen also nur in einer Include-Datei definiert und sie werden aber in beiden Dateien verwendet, meckert der Compiler kein St�ck, egal ob mit oder ohne Include.

Es ist nur wichtig, dass beim Ausf�hren des Codes die Variablen auch zuerst zugewiesen werden und dann verwendet werden.

Edit:
Ganz konkret, w�re es also so richtig/m�glich:

GUI.aal1

Code:

$win=CreateWindow(...)
$button=CreateButton($win, ...)
SetOnEvent($button, "onClick","Button1Clicked")

Main.aal1

Code:

#include("GUI.aal1")

; Do something with $win or $button

While 1
   Sleep(10)
Wend

Func Button1Clicked()
     ConsoleWrite("It worked!")
EndFunc

Page 1 of 3