Weaver for Apache Thrift

Linter, Formatter, LSP Server and a VS Code Extension

Weaver for Apache Thrift adds Apache Thrift support to VS Code.

[!NOTE] Weaver for Apache Thrift is an independent project for Apache Thrift tooling. Apache Thrift is a trademark of The Apache Software Foundation. The extension identifier is kpumuk.thrift-weaver-vscode.

Why This Extension

See errors while you type.
Format whole files or a selected range.
Use symbols, folds, and semantic tokens.
Run with managed thriftls or your own thriftls path.

Install

Option 1: Visual Studio Marketplace

Open the Extensions view in VS Code.
Search for kpumuk.thrift-weaver-vscode.
Click Install.

Marketplace page: Visual Studio Marketplace listing

Option 2: Open VSX Registry

Install from Open VSX (useful for VS Code-compatible editors like VSCodium):

Open VSX listing

Option 3: Install `.vsix`

code --install-extension thrift-weaver-vscode-<version>.vsix --force

Quick Start

Open any .thrift file.
Run Format Document or Format Selection.
If setup fails, set thrift.server.path to your local thriftls binary.

[!IMPORTANT] Managed install is on by default. The extension downloads a matching thriftls binary and checks its SHA-256 hash.

Features

Syntax highlighting.
Diagnostics.
Document format and range format.
Document symbols.
Folding ranges.
Selection ranges.
Semantic tokens.
Command: Weaver for Apache Thrift: Restart Language Server.

Settings

All settings start with thrift..

Main settings:

Server path: use your own thriftls binary.
Server args: pass extra args to thriftls.
Workspace index workers: control parallel workspace indexing (0 = server default).
Line width: set your preferred wrap width.
Trace level: choose off, messages, or verbose.
Managed install: choose if auto install is on.
Manifest URL: set where install info comes from.
Insecure HTTP: allow only for local tests.

Example `settings.json`

{
  // Path to local thriftls (empty = managed install path)
  "thrift.server.path": "",
  // Extra args for thriftls
  "thrift.server.args": [],
  // Parallel workers for workspace indexing (0 = server default)
  "thrift.workspace.indexWorkers": 0,
  // Preferred line width for formatting
  "thrift.format.lineWidth": 100,
  // LSP trace level
  "thrift.trace.server": "off",
  // Enable managed thriftls install
  "thrift.managedInstall.enabled": true,
  // Managed install manifest URL
  "thrift.managedInstall.manifestUrl": "https://github.com/kpumuk/thrift-weaver/releases/latest/download/thriftls-manifest.json",
  // Allow HTTP only for local testing
  "thrift.managedInstall.allowInsecureHttp": false
}

Managed Install Notes

Managed install flow:

Download manifest.
Pick your platform artifact.
Download and verify hash.
Install with rollback.

[!WARNING] Non-HTTPS URLs are blocked unless thrift.managedInstall.allowInsecureHttp is set to true.

Troubleshooting

No errors or format

Open Output panel and check the current channel names:
- Weaver for Apache Thrift
- Weaver for Apache Thrift LSP Trace
Run Weaver for Apache Thrift: Restart Language Server.
Confirm the mode is Thrift.
If needed, set thrift.server.path.

Managed install fails

Check thrift.managedInstall.manifestUrl.
Use HTTPS unless this is local testing.
Check network access from VS Code.
Set thrift.server.path as fallback.

Server starts, then stops

Set thrift.trace.server to verbose.
Restart the language server.
Share logs in a GitHub issue.

Issues: github.com/kpumuk/thrift-weaver/issues

Dmytro Shteflyuk