Scarp Compiler & Runner
Official Visual Studio Code extension for the Scarp language. This is experimental pre-release software that calls the actual Scarp compiler; it does not reimplement the language.
Never publish a stable extension until the Scarp programming language/compiler publishes its first verified stable release.
Implemented
- Recognize .srp files as Scarp.
- Scarp: Run Current File: launch the official compiler in the integrated terminal with program input/output.
- Scarp: Check Current File: use the official compiler's check command, show output and parse supported source diagnostics in Problems.
- Scarp: Show Compiler Version: verify the executable.
- Scarp: Stop Running Program: stop extension-owned terminal sessions.
- Configure executable path, check timeout and seven documented CLI resource budgets.
- Preserve file paths with spaces by passing process arguments directly, without invoking a shell.
Not yet supported: native file compilation and project builds. As of Scarp compiler v0.0.5-alpha.2 there is no compile or build command. No fictional implementation is provided.
Install and run
- Install Scarp from official compiler releases.
- Run scarp --version in the workspace environment, or set scarp.compilerPath to the executable file (Windows example: C:\tools\scarp\scarp.exe).
- Install a verified pre-release VSIX when available, or open the repository in a VS Code Extension Development Host.
- Open a .srp file in a trusted workspace, then use Run or Check in the Command Palette.
print("Hello from Scarp!");
The extension uses the workspace extension host. On Remote SSH, WSL or containers, install the compiler in that environment.
Settings
| Setting |
Purpose |
| scarp.compilerPath |
Full path to executable, or scarp on PATH |
| scarp.checkTimeoutMs |
Timeout for checking (default: 30000 milliseconds) |
| scarp.maxSteps, scarp.maxPrints |
Optional execution limits |
| scarp.maxCallDepth, scarp.maxCalls |
Optional call limits |
| scarp.maxLiveSlots, scarp.maxCaptureBytes, scarp.maxVectorBytes |
Optional memory/resource limits |
Unspecified limits use compiler defaults.
Limitations
- The Scarp language is still alpha and can change. Compatibility must be verified against the real compiler.
- Check can evaluate reachable code; it is not a static-only check.
- Diagnostics use Scarp's current human-readable error location format. Other error text is shown in the Scarp Output channel.
- Only one terminal session per file; terminal output is not duplicated into Problems.
- Unsaved document changes are saved first.
- Native build, native compilation, code completion, AI coding, and debugging are out of scope.
Contributing and testing
Use Node.js 22+, npm and VS Code 1.96+.
npm install
npm run check
npm run package:pre
For release policy and testing see CONTRIBUTING.md and docs/RELEASING.md.
Troubleshooting
Compiler missing: verify it is installed in the same workspace host as VS Code. Set scarp.compilerPath if it is not on PATH.
Invalid version: verify the setting points to an official Scarp executable, not a shell command or another program.
Check failed without Problems: use Scarp: Show Compiler Output to see the full stderr.
Paths containing spaces: do not add wrapping quotes inside scarp.compilerPath.
License
MIT (extension). The separate Scarp compiler is Apache-2.0 licensed.
Visual Studio Marketplace pre-release
The Marketplace publisher is ScarpLang, and the extension identifier is ScarpLang.scarp. The first Marketplace release must be marked Pre-release; a stable release is not allowed until Scarp itself releases a verified stable compiler.
Publishing from GitHub Actions uses the Marketplace's Trusted Publishing policy for scarp-lang/scarp-vscode and .github/workflows/prerelease.yml. It requires no persistent PAT. Marketplace publication is explicitly opt-in through the manual workflow input, never automatic on a normal commit. Follow the release instructions.
