coc-ruff

ruff-lsp extension for coc.nvim.

Install

CocInstall:

:CocInstall @yaegassy/coc-ruff

scoped packages

e.g. vim-plug:

Plug 'yaegassy/coc-ruff', {'do': 'yarn install --frozen-lockfile'}

Note

The ruff command used by ruff-lsp uses the ruff command installed with the ruff-lsp dependency.

To use the ruff command installed in the virtual environment of a project created by venv, poetry, etc., ruff.path must be set to an absolute path.

coc-ruff adds the feature to automatically detect ruff commands in the execution environment and use them in ruff-lsp.

If you do not need this feature, set ruff.useDetectRuffCommand to false.

coc-settings.json:

{
  "ruff.useDetectRuffCommand": false
}

Order of detection of ruff-lsp used by extensions

coc-ruff detects and starts ruff-lsp in the following priority order.

1. ruff.serverPath (If there is a setting)
2. current python3/python environment (e.g. ruff-lsp in global or virtual environment)
3. built-in ruff-lsp (Installation commands are also provided)

Bult-in install

coc-ruff allows you to create an extension-only "venv" and install ruff-lsp.

When using coc-ruff for the first time, if ruff-lsp is not present in the runtime environment, you will be prompted to do a built-in install.

To use the built-in installation feature, execute the following command.

:CocCommand ruff.builtin.installServer

Configuration options

• ruff.enable: Enable coc-ruff extension, default: true
• ruff.useDetectRuffCommand: Automatically detects the ruff command in the execution environment and sets ruff.path, default: true
• ruff.serverPath: Custom path to the ruff-lsp command. If not set, the ruff-lsp command found in the current Python environment or in the venv environment created for the extension will be used, default: ""
• ruff.builtin.pythonPath: Python 3.x path (Absolute path) to be used for built-in install, default: ""
• ruff.trace.server: Traces the communication between coc.nvim and the ruff-lsp, default: "off"

Other settings have the same configuration as ruff-vscode.

Commands

• ruff.executeAutofix: Fix all auto-fixable problems
• ruff.executeOrganizeImports: Format imports
• ruff.restart: Restart Server
• ruff.builtin.installServer: Install ruff-lsp
  • It will be installed in this path:
    • Mac/Linux:
      • ~/.config/coc/extensions/@yaegassy/coc-ruff-data/ruff-lsp/venv/bin/ruff-lsp
    • Windows:
      • ~/AppData/Local/coc/extensions/@yaegassy/coc-ruff-data/ruff/venv/Scripts/ruff-lsp.exe

Thanks

• charliermarsh/ruff
• charliermarsh/ruff-lsp
• charliermarsh/ruff-vscode

License

MIT

This extension is built with create-coc-extension