Ruff Binary Resolution Ladder

VS Code Server Execution & Resolution Order

RESOLVER PRECEDENCE (HIGH → LOW) UNTRUSTED BYPASS INVERTS CONTROL TRUST GATE: PASSED USER INTERPRETER sys.prefix / venv site-packages/ruff EXEC: find_ruff.py 1. ruff.path Explicit user/workspace setting path override TRUSTED 2. importStrategy Checks if configured to 'useBundled' directly WORKSPACE-DEPENDENT 3. find_ruff_binary_path.py Executes finder script inside target environment ENVIRONMENT-DEPENDENT 4. PATH Lookup Searches system environment $PATH directories GLOBAL 5. Bundled Fallback Ships binary packaged inside VS Code extension LAST RESORT
RUNG 1 OF 5

ruff.path

TRUSTED
WHEN IT IS USED

Triggered when the user explicitly configures custom path settings (`ruff.path`) in VS Code workspace or user settings.

SERVER IMPLEMENTATION (server.ts)
const customPath = getSetting<string[]>("path"); if (customPath && customPath.length > 0) { return findBinaryInPaths(customPath); }
FAILURE MODE

Specified path does not exist, has incorrect execution permissions, or points to an incompatible OS binary.