Changelog

See here for the Ruff release notes.

2024.30.0

This release upgrades the bundled Ruff version to v0.5.0. Check out the blog post for a migration guide and overview of the changes!

This release also adds a new showSyntaxErrors setting that controls whether Ruff shows syntax errors. Disabling the syntax errors can be helpful when using the Ruff extension with other Python extensions that also show syntax errors.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.28.0...2024.30.0

2024.28.0

This release upgrades the bundled Ruff version to v0.4.9, which includes a number of bug fixes and improvements to ruff server.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.26.0...2024.28.0

2024.26.0

This release upgrades the bundled Ruff version to v0.4.8, which includes a number of bug fixes and improvements to ruff server.

To start using ruff server, add the following to your settings.json:

{
  "ruff.nativeServer": true
}

Or see the README for more.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.24.0...2024.26.0

2024.24.0

This release upgrades the bundled Ruff version to v0.4.7, which includes a number of bug fixes and improvements to ruff server.

To start using ruff server, add the following to your settings.json:

{
  "ruff.nativeServer": true
}

Or see the README for more.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.22.0...2024.24.0

2024.22.0

This release upgrades the bundled Ruff version to v0.4.5.

This release also stabilizes ruff server as an available feature, along with its new configuration options. ruff server supports the same feature set as ruff-lsp, powering linting, formatting, and code fixes in Ruff's editor integrations -- but with superior performance and no installation required. We'd love your feedback!

To start using ruff server, add the following to your settings.json:

{
  "ruff.nativeServer": true
}

Or see the README for more.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.20.0...2024.22.0

2024.21.0-dev

This pre-release upgrades the bundled Ruff version to v0.4.2.

Several new extension settings have been introduced, which allow you to override certain options passed into the linter and formatter. See #10984 for more details.

The v0.4.2 server introduces several other features and improvements:

Diagnostics for open files are now automatically refreshed when a configuration file is modified (#10988)
File configuration is now resolved on a per-file basis, which matches how the CLI resolves configuration (#10950)
Hover documentation for noqa codes has been implemented (#11096)
Major errors are now shown as pop-up notifications (#10951)

This release also includes a bug fix:

Ruff-specific source actions (such as source.organizeImports.ruff) now work as intended (#10916)

2024.20.0

This release upgrades the bundled Ruff version to v0.4.1.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.18.0...2024.20.0

2024.19.0-dev

This pre-release upgrades the bundled Ruff version to v0.3.6.

The extension can now detect and use local ruff executables on your system, though it can still fall back to the bundled Ruff binary.

The v0.3.6 server introduces several major features:

Source actions like source.fixAll and source.organizeImports are now supported.
Extension commands are now supported.
Some extension settings now work as expected. See the relevant PR for more details.
Linter/formatter configuration is now reloaded automatically when you make changes to ruff.toml / pyproject.toml files.

This release also brings significant quality-of-life improvements and fixes several bugs.

2024.18.0

This release upgrades the bundled Ruff version to v0.4.0.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.16.0...2024.18.0

2024.17.0-dev

This pre-release introduces support for the new, experimental Ruff language server (ruff server). It also upgrades the bundled Ruff version to v0.3.3.

ruff server is still missing some core functionality and stability guarantees - this pre-release is intended for early testing. The server can be enabled and disabled with the experimentalServer setting. A restart is required after changing this setting.

At the moment, the experimental server has the following known limitations:

Most extension settings are not yet supported, and many will not be needed after the transition to the new server is finished. For example, editor.codeActionsOnSave does not work at the moment due to missing support for source-level code actions (see below). Additionally, lint.args / format.args will be replaced in the future with specific configuration fields for the linter and formatter.
Commands/source-level code actions like Fix all and Organize Imports have not yet been implemented (Quick Fixes should still work, though).
Hierarchial configuration for individual files is not yet supported. At the moment, the language server uses the ruff.toml / pyproject.toml at the workspace root to configure the formatter and linter.
Jupyter Notebook files are not supported yet.
Using local Ruff binaries is not yet supported. At the moment, the extension will always use the bundled Ruff binary. (v0.3.3)

These limitations will all be resolved in future versions.

2024.16.0

This release upgrades the bundled Ruff version to v0.3.1.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.14.0...2024.16.0

2024.14.0

This release upgrades the bundled Ruff version to v0.3.0.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.12.0...2024.14.0

2024.12.0

This release upgrades the bundled Ruff version to v0.2.2.

As of v0.2.2, Ruff now accepts configuration for arbitrary settings on command-line arguments via the --config flag, which in turn allows for configuration arbitrary settings within the VS Code extension.

For example, to set Ruff's lint.isort.combine-as-imports setting to false, add the following to your settings.json:

{
  "ruff.lint.args": ["--config", "lint.isort.combine-as-imports=false"]
}

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.10.0...2024.12.0

2024.10.0

This release includes support for "Format Selection" (i.e., the ability to format specific lines within a source file) for Ruff v0.2.1 and later.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.8.0...2024.10.0

2024.8.0

This release upgrades the bundled Ruff version to v0.2.0.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.6.0...2024.8.0

2024.6.0

This release upgrades the Ruff LSP in anticipation of Ruff's upcoming v0.2.0 release

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.4.0...2024.6.0

2024.4.0

This release upgrades the bundled Ruff version to v0.1.14 and adds two additional settings to the extension:

ruff.lint.enable: Defaults to true. Set to false to use Ruff for formatting exclusively.
ruff.ignoreStandardLibrary: Defaults to true. Set to false to disable the extension's standard library exclusion logic.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.2.0...2024.4.0

2024.2.0

This release upgrades the bundled Ruff version to v0.1.13 and adds Alpine Linux support to the extension.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2024.0.0...2024.2.0

2024.0.0

This release upgrades the bundled Ruff version to v0.1.11 and adds support for Notebook-wide code actions on save via the notebook.codeActionsOnSave setting.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.60.0...2024.0.0

2023.60.0

This release upgrades the bundled Ruff version to v0.1.9.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.58.0...2023.60.0

2023.58.0

This release avoids surfacing errors when formatting files with syntax errors.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.56.0...2023.58.0

2023.56.0

This release fixes a bug in which the bundled version of Ruff was incompatible with ARM Mac devices.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.54.0...2023.56.0

2023.54.0

This release fixes a bug in which Ruff overwrite files when invalid settings were provided via ruff.lint.args or ruff.format.args.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.52.0...2023.54.0

2023.52.0

This release upgrades the bundled Ruff version to v0.1.8.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.50.0...2023.52.0

2023.50.0

This release fixes a bug in which Ruff overwrite excluded files during formatting.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.48.0...2023.50.0

2023.48.0

This release fixes a bug in which syntax errors caused files to clear when formatting.

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.46.0...2023.48.0

2023.46.0

This release includes full support for using Ruff with Jupyter Notebooks in VS Code. For example:

{
  "notebook.formatOnSave.enabled": true,
  "notebook.codeActionsOnSave": {
    "source.fixAll": true,
    "source.organizeImports": true
  },
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff"
  }
}

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.44.0...2023.46.0

2023.44.0

This release includes full support for using Ruff as a Python formatter via Ruff's ruff format command.

You can configure Ruff to format Python code by marking it as your default formatter in VS Code's settings.json:

{
  "[python]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "charliermarsh.ruff"
  }
}

Full Changelog: https://github.com/astral-sh/ruff-vscode/compare/2023.42.0...2023.44.0

2023.42.0

This release is required for compatibility with Ruff v0.1.0+ which includes breaking changes.

Ruff fixes are now labeled as "safe" or "unsafe". By default, the "Fix all" action will no longer apply unsafe fixes. However, unsafe fixes can be applied manually with the "Quick fix" action. Application of unsafe fixes when using "Fix all" can be enabled by setting unsafe-fixes = true in your Ruff configuration file or adding --unsafe-fixes flag to the "Lint args" setting.