This project is making heavily use of AI Agents, if you have a problem with that just don't use it. Thanks!

`revofmt-vscode`, revo formatting in vs code

open a .rv or .revo file, run Format Document, get formatted code. it works on your unsaved buffer. format-on-save is off until you enable it.

get started | settings | format on save | develop

get started

you need vs code >=1.85 and revofmt. download the formatter or build it. the download is for linux x86_64 GNU, with glibc >=2.34 and libgcc_s. this extension doesn't install the formatter for you.

check that it's on your PATH:

revofmt --version

download the VSIX and SHA256SUMS from the standalone extension release. from the directory containing both files:

sha256sum --check SHA256SUMS && \
  code --install-extension revo-formatter-0.1.7.vsix

to build the extension yourself, use node.js >=22 and npm:

git clone https://github.com/w0x7y/revofmt-vscode.git
cd revofmt-vscode
npm ci
npm run package
code --install-extension revo-formatter-0.1.7.vsix

you can also use Extensions: Install from VSIX in the command palette. the marketplace upload is being prepared. the publishing guide describes the prepared upload.

the extension ID is w0x7y.revo-formatter. if you installed the older w0x7y.revofmt package, disable or uninstall it and select Revofmt Code Formatter again. update editor.defaultFormatter to the new ID when using format-on-save.

open a .rv or .revo file in a trusted workspace. the language should say Revo. run Format Document on this:

let x=1

and you get:

let x = 1

if another formatter is selected, use Format Document With and choose Revofmt Code Formatter. for an untitled document, select Revo as the language first. use your existing language extension for highlighting, completion and diagnostics.

settings

these are the defaults. put your changes in vs code's settings.json:

{
  "revofmt.executable": "revofmt",
  "revofmt.indentWidth": 2,
  "revofmt.lineWidth": 80,
  "revofmt.timeoutMs": 5000
}

if vs code can't find the formatter, set revofmt.executable to its absolute path. paths are literal; ~, environment variables and shell commands aren't expanded. indentation accepts 1 to 8 spaces. width accepts 20 to 240 columns and is a soft target. the timeout is in milliseconds, from 1 to 2147483647.

formatting runs only in trusted workspaces. review a workspace's executable setting before trusting it. in SSH, containers or WSL, install the extension and formatter in that environment and use a path that exists there. browser-only and virtual workspaces aren't supported.

format on save

add this to your user or workspace settings to opt in:

{
  "[revo]": {
    "editor.defaultFormatter": "w0x7y.revo-formatter",
    "editor.formatOnSave": true,
    "editor.formatOnSaveMode": "file",
    "files.trimTrailingWhitespace": false,
    "files.insertFinalNewline": false,
    "files.trimFinalNewlines": false
  }
}

keep the three files settings false. separate save actions can change whitespace inside multiline strings and comments, even when formatting fails. check other extensions' save actions too.

what it preserves

revofmt checks syntax, literal and comment bytes, and that formatting twice gives the same result. the extension applies only successful current output. failed, canceled, stale or timed-out requests leave the buffer alone.

UTF-8 LF and CRLF buffers are supported. edits that would change opaque bytes through vs code's line-ending normalization are rejected. vs code may already normalize mixed raw-file endings when it opens a file. source and stdout are limited to 262,144 bytes, stderr to 65,536 bytes. the development guide has the details.

develop

with node.js >=20 and an installed formatter:

npm test                               # revofmt on PATH
REVOFMT_BIN=/absolute/path/to/revofmt scripts/verify

For formatter v0.1.2 or a source build using Revo e94e6d8 or later, add REVOFMT_CURRENT_SYNTAX=1 to verify range adjacency and invalid interpolation mode rejection without edits. CI enables these checks with the pinned v0.1.2 formatter. Leave the option unset when testing an older formatter.

the tests cover real CLI formatting, byte preservation, document changes, workspace trust, cancellation, deadlines and process cleanup.

with a desktop vs code and a working display, run the separate native host test:

REVOFMT_BIN=/absolute/path/to/revofmt npm run test:host

it uses a disposable workspace and temporary settings. your personal settings stay unchanged. see development and packaging for the host test's scope and how to rebuild the VSIX.

credits

MIT. started in revo-formatter/editors/vscode at commit 14bafd8ede11829157d0bd15ebd01cc667c4efaa. the formatter uses revo, also MIT.

Revofmt Code Formatter

w0x7y

revofmt-vscode, revo formatting in vs code