Build and Run

Build programs automatically and run them with input from source code comments.

• Different build and run commands for different languages.
• Project specific commands (in project settings).
• Run untitled (not saved) files.
• Any language.
• Fully customizable.
• Multiple runs.
• Format code.
• Compare with expected output.

Remember to add key bindings.

Contributions are welcome (please create an issue first to discuss the idea).

Installation

Install from VSCode Marketplace. See INSTALL.md for more details.

Configuration

Modify language agnostic options by searching @ext:glelesius.build-and-run in the settings UI (ctrl+shift+P and Preferences: Open Settings (UI)).

Language-specific options must be configured using json format (ctrl+shift+P and Preferences: Open User Settings (JSON) or Preferences: Open Workspace Settings (JSON)).

Example configuration (don't just replace everything!, add this inside settings object):

{
    // There should already be some existing values, don't delete them, append this:
    "buildAndRun": {
        "cpp": {
            "build": "g++ -std=gnu++23 -Wall -Wextra -O2 \"${file}\" -o \"${file_base_name}.exe\"",
            "debugBuild": "g++ -std=gnu++23 -Wall -Wextra -g -O0 \"${file}\" -o \"${file_base_name}.exe\"",
            "inputBegin": "/*input\n",
            "inputEnd": "*/",
            "outputBegin": "/*output\n",
            "outputEnd": "*/",
            "run": "\"./${file_base_name}.exe\"",
            "debug": "gdb -q -ex \"set print thread-events off\" -ex run -ex \"bt -entry-values compact -frame-arguments scalar -full\" \"${file_base_name}.exe\"",
            "ext": "cpp",
            "format": "astyle --indent=tab --mode=c --project=none"
        },
        "python": {
            "inputBegin": "\"\"\"input\n",
            "inputEnd": "\"\"\"",
            "outputBegin": "\"\"\"output\n",
            "outputEnd": "\"\"\"",
            "run": "python -Xutf8 -u \"${file}\"",
            "ext": "py",
            "format": "ruff check - --fix | ruff format --line-length 120 -"
        }
    }
}

Full list of language names can be found at VSC docs.

For more details on what each option does, please read comments in src/settings.ts

In command strings you can use the following variables:

• ${file} will be replaced by the name of the currently open file (or temp file if untitled).
• ${file_path} by the directory of the currently open file (or temp directory).
• ${file_base_name} by ${file} without extension.
• ${workspace_path} by the path of the first folder of the workspace (or ${file_path} if no workspace is open).

Commands

List of commands (run by pressing ctrl+shift+P or add a key binding):

B&R: Build and Run with input
B&R: Build
B&R: Build and Debug with input
B&R: Kill running program
B&R: Format
B&R: Cleanup temp files

Input from comments

C++ example:

#include <bits/stdc++.h>
/*input
a
*/
/*output
aa
*/
/*input
b
*/
int main() {
    std::string x; std::cin >> x; std::cout << x << x;
}

Example output (program executed twice, with different inputs):

[Built in 0.816s]
aa
Output matched
[Finished in 0.006s]
bb
[Finished in 0.006s]

Python example:

"""input
a
"""
"""output
aa
"""
"""input
b
"""
x = input()
print(x, x, sep='')