Jacques Programming Language — VS Code extension

This extension ships a full Jacques (JCS) toolkit inside the .vsix:

You only need Python 3 with tkinter on your machine (standard on most installs). No separate “Jacques SDK” install is required.

Commands (Command Palette)

• Jacques: Run Current File — runs the bundled compiler on the active .jcs file in the integrated terminal.
• Jacques: Open Examples Folder — opens the bundled examples directory on your system (Explorer / Finder).
• Jacques: Open Language Documentation — opens docs/LANGUAGE.md from this extension.

Run from terminal (bundled paths)

After install, the extension lives under your VS Code extensions directory, for example:

%USERPROFILE%\.vscode\extensions\<publisher>.jacques-language-<version>\

Run a file using the bundled compiler (adjust the version path):

python "%USERPROFILE%\.vscode\extensions\<publisher>.jacques-language-<version>\runtime\jcs_compiler.py" "C:\path\to\file.jcs"

Or use Jacques: Run Current File — it resolves the bundled runtime automatically.

For publishers: packaging

From the vscode-jacques folder, vsce runs vscode:prepublish, which copies the latest compiler, examples, and language doc from the parent jacques/ repo into this extension before the .vsix is built.

npm install -g @vscode/vsce
vsce package

Ensure the parent folder contains jcs_compiler.py, jcs_gui.py, jcs_stdlib.py, examples/, README.md, and media/jacques-logo.svg before publishing.

Troubleshooting: “Cannot read the extension” / ScanningExtension

The publisher field in package.json must be lowercase (letters, numbers, hyphens only). If it contains capitals, VS Code can fail while scanning the extension folder.

After fixing publisher, remove the broken copy under %USERPROFILE%\.vscode\extensions\, then reinstall (Developer: Install Extension from Location…).

License

MIT (same as the Jacques language project).