goome docs

VS Code

The goome extension

vscode-goome is on the VS Code Marketplace. Search goome in Extensions, or:

code --install-extension goome-ui.vscode-goome

On VSCodium and the other forks it is on Open VSX, search goome there too. Offline, grab the .vsix from its releases and use Extensions > … > Install from VSIX.

The side panel 0.5. Click the goome icon in the activity bar. It has:

The rest:

Settings: goome.cli points at your own goome or goome.py, goome.python picks the Python.

Per language

Language Extensions
C C/C++ (ms-vscode.cpptools), and CMake Tools (ms-vscode.cmake-tools) if you use CMake
C# C# Dev Kit (ms-dotnettools.csdevkit)
Python Python (ms-python.python)
Rust 0.5 rust-analyzer (rust-lang.rust-analyzer), CodeLLDB (vadimcn.vscode-lldb) to debug. More
Node 0.5 nothing extra, the types come with the package. More
Go 0.5 Go (golang.go). More
Zig 0.5 Zig Language (ziglang.vscode-zig), CodeLLDB to debug. More
Lua 0.5 Lua (sumneko.lua). More

C, your own project

  1. Folder with goome.h, a goome.c with the two implementation lines and your main.c (the get script makes these).
  2. File > Open Folder.
  3. .vscode/tasks.json for Ctrl+Shift+B:
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build",
      "type": "shell",
      "command": "gcc -g -O0 -o myapp main.c goome.c",
      "windows": { "command": "cl /Zi /Od main.c goome.c /Fe:myapp.exe" },
      "group": { "kind": "build", "isDefault": true },
      "problemMatcher": ["$gcc"]
    }
  ]
}
  1. .vscode/launch.json with a cppdbg config, program set to ${workspaceFolder}/myapp and "preLaunchTask": "build". Windows is cppvsdbg and myapp.exe, Mac needs "MIMode": "lldb". Then F5.

cl only works if VS Code got started from the Visual Studio developer prompt. With mingw use the gcc line on Windows too.

C, inside the c-goome repo

Theres already a .vscode folder, open the repo and install the extensions it asks for. It configures itself from the CMake presets.

C#

  1. dotnet new console -o MyApp, open the folder.
  2. dotnet add package GoomeSharp in the terminal. Working on a csharp-goome clone instead? ./build.sh there and dotnet add reference ../csharp-goome/src/GoomeSharp/GoomeSharp.csproj.
  3. F5, C# Dev Kit makes the launch config.

Python

  1. Python: Create Environment in the command palette, pick it as the interpreter.
  2. pip install goome in the terminal
  3. F5 on your script.

Add "env": {"GOOME_BACKEND": "test", "GOOME_TEST_SHOTS": "shots/"} to the launch config for the test backend.

Gotchas

On Windows C# and Python need goome.dll next to your exe or in runtimes/win-x64/native/. GoomeSharp copies it on build but only if ./build.sh win (or build.sh in Git Bash with mingw) made it first, otherwise its a DllNotFoundException. GOOME_NATIVE=C:\path\to\folder points somewhere else.

Mac permission prompts say VS Code, not your app. Why.