1. Download and Install
Download and extract argentum-demo.7z archive from Assets at https://github.com/karol11/argentum/releases/
Check it with your preferred anti-malware.
Install and launch VSCode https://code.visualstudio.com/download
Launch VSCode and install extension CodeLLDB
2. Open project
Open the folder with the extracted demo:
Since we will run executables (agc, llvm-link) we need to "trust" its content. (Yes trust me, I am an engineer).
3. Configure debugger
The only parameter that should be set is the path to the liblldb.dll that's located inside the argentum_demo/bin directory. It should be fixed in the argentum-demo/.vscode/settings.json config:
{
"lldb.displayFormat": "auto",
"lldb.showDisassembly": "auto",
"lldb.dereferencePointers": true,
"lldb.consoleMode": "commands",
"lldb.library": "<DIR>/argentum-demo/bin/liblldb.dll"
}Replace "<DIR>" with your path to the directory where the argentum-demo is located.
4. Syntax highlight
Open the hello_world.ag in the src directory.
In the lower right corner of the status bar click on plain text to switch color highlighting mode.
Select "Configure file association for *.ag
Select Rust of Swift from the list, because they have the closest syntax.
5. Compile and Run
Press Ctrl+Shift+B to compile and run the `hello_world application.
It should write "Hi there" in console:
Do the same with demo.ag: open and Ctrl+Shift+B. It should compile and run:
6. Debugger
Open graph.ag, select any line of code and press F9 to set a breakpoint.
Press F5 to compile the application in debug mode and run it in debugger.
When program stops on a break point, try step through the code (F10/F11) and inspect variables. The separate tutorial on debugging is here: argentum-debugger-v1.
That's it for now.