Releases: astral-sh/ruff
Releases · astral-sh/ruff
0.8.0
Release Notes
Check out the blog post for a migration guide and overview of the changes!
Breaking changes
See also, the "Remapped rules" section which may result in disabled rules.
-
Default to Python 3.9
Ruff now defaults to Python 3.9 instead of 3.8 if no explicit Python version is configured using
ruff.target-versionorproject.requires-python(#13896) -
Changed location of
pydoclintdiagnosticspydoclintdiagnostics now point to the first-line of the problematic docstring. Previously, this was not the case.If you've opted into these preview rules but have them suppressed using
noqacomments in
some places, this change may mean that you need to move thenoqasuppression
comments. Most users should be unaffected by this change. -
Use XDG (i.e.
~/.local/bin) instead of the Cargo home directory in the standalone installerPreviously, Ruff's installer used
$CARGO_HOMEor~/.cargo/binfor its target install directory. Now, Ruff will be installed into$XDG_BIN_HOME,$XDG_DATA_HOME/../bin, or~/.local/bin(in that order).This change is only relevant to users of the standalone Ruff installer (using the shell or PowerShell script). If you installed Ruff using uv or pip, you should be unaffected.
-
Changes to the line width calculation
Ruff now uses a new version of the unicode-width Rust crate to calculate the line width. In very rare cases, this may lead to lines containing Unicode characters being reformatted, or being considered too long when they were not before (
E501).
Removed Rules
The following deprecated rules have been removed:
missing-type-self(ANN101)missing-type-cls(ANN102)syntax-error(E999)pytest-missing-fixture-name-underscore(PT004)pytest-incorrect-fixture-name-underscore(PT005)unpacked-list-comprehension(UP027)
Remapped rules
The following rules have been remapped to new rule codes:
flake8-type-checking:TCHtoTC
Stabilization
The following rules have been stabilized and are no longer in preview:
builtin-import-shadowing(A004)mutable-contextvar-default(B039)fast-api-redundant-response-model(FAST001)fast-api-non-annotated-dependency(FAST002)dict-index-missing-items(PLC0206)pep484-style-positional-only-parameter(PYI063)redundant-final-literal(PYI064)bad-version-info-order(PYI066)parenthesize-chained-operators(RUF021)unsorted-dunder-all(RUF022)unsorted-dunder-slots(RUF023)assert-with-print-message(RUF030)unnecessary-default-type-args(UP043)
The following behaviors have been stabilized:
ambiguous-variable-name(E741): Violations in stub files are now ignored. Stub authors typically don't control variable names.printf-string-formatting(UP031): Report allprintf-like usages even if no autofix is available
The following fixes have been stabilized:
zip-instead-of-pairwise(RUF007)
Preview features
- [
flake8-datetimez] Exemptmin.time()andmax.time()(DTZ901) (#14394) - [
flake8-pie] Mark fix as unsafe if the following statement is a string literal (PIE790) (#14393) - [
flake8-pyi] New ruleredundant-none-literal(PYI061) (#14316) - [
flake8-pyi] Add autofix forredundant-numeric-union(PYI041) (#14273) - [
ruff] New rulemap-int-version-parsing(RUF048) (#14373) - [
ruff] New ruleredundant-bool-literal(RUF038) (#14319) - [
ruff] New ruleunraw-re-pattern(RUF039) (#14446) - [
pycodestyle] Exemptpytest.importorskip()calls (E402) (#14474) - [
pylint] Autofix suggests using sets when possible (PLR1714) (#14372)
Rule changes
invalid-pyproject-toml(RUF200): Updated to reflect the provisionally accepted PEP 639.- [
flake8-pyi] Avoid panic in unfixable case (PYI041) (#14402) - [
flake8-type-checking] Correctly handle quotes in subscript expression when generating an autofix (#14371) - [
pylint] Suggest correct autofix for__contains__(PLC2801) (#14424)
Configuration
- Ruff now emits a warning instead of an error when a configuration
ignores a rule that has been removed (#14435) - Ruff now validates that
lint.flake8-import-conventions.aliasesonly uses valid module names and aliases (#14477)
Contributors
- @AlexWaygood
- @CarrotManMatt
- @Daverball
- @Glyphack
- @InSyncWithFoo
- @MichaReiser
- @cake-monotone
- @charliermarsh
- @dhruvmanila
- @diceroll123
- @dylwil3
- @hauntsaninja
- @konstin
- @sbrugman
- @sharkdp
- @takaya0
- @tjkuson
- @zanieb
Install ruff 0.8.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.8.0/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.8.0/ruff-installer.ps1 | iex"Download ruff 0.8.0
| File | Platform | Checksum |
|---|---|---|
| ruff-aarch64-apple-darwin.tar.gz | Apple Silicon macOS | checksum |
| ruff-x86_64-apple-darwin.tar.gz | Intel macOS | checksum |
| ruff-aarch64-pc-windows-msvc.zip | ARM64 Windows | checksum |
| ruff-i686-pc-windows-msvc.zip | x86 Windows | checksum |
| ruff-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| [ruff-aarch64-unknown-linux-gnu.tar.gz](https://github.com/astral-sh/ruff/releases/download/0.8.0/ruff-aarch64-... |
0.7.4
Release Notes
Preview features
- [
flake8-datetimez] Detect usages ofdatetime.max/datetime.min(DTZ901) (#14288) - [
flake8-logging] Implementroot-logger-calls(LOG015) (#14302) - [
flake8-no-pep420] Detect empty implicit namespace packages (INP001) (#14236) - [
flake8-pyi] Add "replace withSelf" fix (PYI019) (#14238) - [
perflint] Implement quick-fix formanual-list-comprehension(PERF401) (#13919) - [
pylint] Implementshallow-copy-environ(W1507) (#14241) - [
ruff] Implementnone-not-at-end-of-union(RUF036) (#14314) - [
ruff] Implementationunsafe-markup-callfromflake8-markupsafeplugin (RUF035) (#14224) - [
ruff] Report problems forattrsdataclasses (RUF008,RUF009) (#14327)
Rule changes
- [
flake8-boolean-trap] Exclude dunder methods that define operators (FBT001) (#14203) - [
flake8-pyi] Add "replace withSelf" fix (PYI034) (#14217) - [
flake8-pyi] Always autofixduplicate-union-members(PYI016) (#14270) - [
flake8-pyi] Improve autofix for nested and mixed type unions forunnecessary-type-union(PYI055) (#14272) - [
flake8-pyi] Mark fix as unsafe when type annotation contains comments forduplicate-literal-member(PYI062) (#14268)
Server
- Use the current working directory to resolve settings from
ruff.configuration(#14352)
Bug fixes
- Avoid conflicts between
PLC014(useless-import-alias) andI002(missing-required-import) by consideringlint.isort.required-importsforPLC014(#14287) - [
flake8-type-checking] Skip quoting annotation if it becomes invalid syntax (TCH001) - [
flake8-pyi] Avoid usingtyping.Selfin stub files pre-Python 3.11 (PYI034) (#14230) - [
flake8-pytest-style] Flagpytest.raisescall with keyword argumentexpected_exception(PT011) (#14298) - [
flake8-simplify] Infer "unknown" truthiness for literal iterables whose items are all unpacks (SIM222) (#14263) - [
flake8-type-checking] Fix false positives fortyping.Annotated(TCH001) (#14311) - [
pylint] Allowawaitat the top-level scope of a notebook (PLE1142) (#14225) - [
pylint] Fix miscellaneous issues inawait-outside-asyncdetection (PLE1142) (#14218) - [
pyupgrade] Avoid applying PEP 646 rewrites in invalid contexts (UP044) (#14234) - [
pyupgrade] Detect permutations in redundant open modes (UP015) (#14255) - [
refurb] Avoid triggeringhardcoded-string-charsetfor reordered sets (FURB156) (#14233) - [
refurb] Further special cases added toverbose-decimal-constructor(FURB157) (#14216) - [
refurb] UseUserStringinstead of non-existentUserStr(FURB189) (#14209) - [
ruff] Avoid treating lowercase letters as# noqacodes (RUF100) (#14229) - [
ruff] Do not report whenOptionalhas no type arguments (RUF013) (#14181)
Documentation
- Add "Notebook behavior" section for
F704,PLE1142(#14266) - Document comment policy around fix safety (#14300)
Contributors
- @AlexWaygood
- @Daverball
- @Glyphack
- @InSyncWithFoo
- @MichaReiser
- @carljm
- @charliermarsh
- @dhruvmanila
- @dylwil3
- @github-actions
- @harupy
- @nijel
- @pgiraud
- @randolf-scholz
- @renovate
- @sbrugman
- @sharkdp
- @w0nder1ng
Install ruff 0.7.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.7.4/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.7.4/ruff-installer.ps1 | iex"Download ruff 0.7.4
| File | Platform | Checksum |
|---|---|---|
| ruff-aarch64-apple-darwin.tar.gz | Apple Silicon macOS | checksum |
| ruff-x86_64-apple-darwin.tar.gz | Intel macOS | checksum |
| ruff-aarch64-pc-windows-msvc.zip | ARM64 Windows | checksum |
| ruff-i686-pc-windows-msvc.zip | x86 Windows | checksum |
| ruff-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| ruff-aarch64-unknown-linux-gnu.tar.gz | ARM64 Linux | checksum |
| ruff-i686-unknown-linux-gnu.tar.gz | x86 Linux | checksum |
| ruff-powerpc64-unknown-linux-gnu.tar.gz | PPC64 Linux | checksum |
| ruff-powerpc64le-unknown-linux-gnu.tar.gz | PPC64LE Linux | checksum |
| ruff-s390x-unknown-linux-gnu.tar.gz | S390x Linux | checksum |
| ruff-x86_64-unknown-linux-gnu.tar.gz | x64 Linux | checksum |
| ruff-armv7-unknown-linux-gnueabihf.tar.gz | ARMv7 Linux | checksum |
| ruff-aarch64-unknown-linux-musl.tar.gz | ARM64 MUSL Linux | checksum |
| ruff-i686-unknown-linux-musl.tar.gz | x86 MUSL Linux | checksum |
| ruff-x86_64-unknown-linux-musl.tar.gz | x64 MUSL Linux | checksum |
| [ruff-arm-unknown-linux-musleabihf.tar.gz](h... |
0.7.3
Release Notes
Preview features
- Formatter: Disallow single-line implicit concatenated strings (#13928)
- [
flake8-pyi] Include all Python file types forPYI006andPYI066(#14059) - [
flake8-simplify] Implementsplit-of-static-string(SIM905) (#14008) - [
refurb] Implementsubclass-builtin(FURB189) (#14105) - [
ruff] Improve diagnostic messages and docs (RUF031,RUF032,RUF034) (#14068)
Rule changes
- Detect items that hash to same value in duplicate sets (
B033,PLC0208) (#14064) - [
eradicate] Better detection of IntelliJ language injection comments (ERA001) (#14094) - [
flake8-pyi] Add autofix fordocstring-in-stub(PYI021) (#14150) - [
flake8-pyi] Updateduplicate-literal-member(PYI062) to alawys provide an autofix (#14188) - [
pyflakes] Detect items that hash to same value in duplicate dictionaries (F601) (#14065) - [
ruff] Fix false positive for decorators (RUF028) (#14061)
Bug fixes
- Avoid parsing joint rule codes as distinct codes in
# noqa(#12809) - [
eradicate] ignore# language=in commented-out-code rule (ERA001) (#14069) - [
flake8-bugbear] - do not runmutable-argument-defaulton stubs (B006) (#14058) - [
flake8-builtins] Skip lambda expressions inbuiltin-argument-shadowing (A002)(#14144) - [
flake8-comprehension] Also remove trailing comma while fixingC409andC419(#14097) - [
flake8-simplify] Allowopenwithout context manager inreturnstatement (SIM115) (#14066) - [
pylint] Respect hash-equivalent literals initeration-over-set(PLC0208) (#14063) - [
pylint] Update known dunder methods for Python 3.13 (PLW3201) (#14146) - [
pyupgrade] - ignore kwarg unpacking forUP044(#14053) - [
refurb] Parse more exotic decimal strings inverbose-decimal-constructor(FURB157) (#14098)
Documentation
- Add links to missing related options within rule documentations (#13971)
- Add rule short code to mkdocs tags to allow searching via rule codes (#14040)
Install ruff 0.7.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.7.3/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.7.3/ruff-installer.ps1 | iex"Download ruff 0.7.3
0.7.2
Release Notes
Preview features
- Fix formatting of single with-item with trailing comment (#14005)
- [
pyupgrade] Add PEP 646Unpackconversion to*with fix (UP044) (#13988)
Rule changes
- Regenerate
known_stdlibs.rswith stdlibs 2024.10.25 (#13963) - [
flake8-no-pep420] Skip namespace package enforcement for PEP 723 scripts (INP001) (#13974)
Server
- Fix server panic when undoing an edit (#14010)
Bug fixes
- Fix issues in discovering ruff in pip build environments (#13881)
- [
flake8-type-checking] Fix false positive forsingledispatchmethod(TCH003) (#13941) - [
flake8-type-checking] Treat return type ofsingledispatchas runtime-required (TCH003) (#13957)
Documentation
- [
flake8-simplify] Include caveats of enablingif-else-block-instead-of-if-exp(SIM108) (#14019)
Install ruff 0.7.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.7.2/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.7.2/ruff-installer.ps1 | iex"Download ruff 0.7.2
0.7.1
Release Notes
Preview features
- Fix
E221andE222to flag missing or extra whitespace around==operator (#13890) - Formatter: Alternate quotes for strings inside f-strings in preview (#13860)
- Formatter: Join implicit concatenated strings when they fit on a line (#13663)
- [
pylint] Restrictiteration-over-setto only work on sets of literals (PLC0208) (#13731)
Rule changes
- [
flake8-type-checking] Support auto-quoting when annotations contain quotes (#11811)
Server
- Avoid indexing the workspace for single-file mode (#13770)
Bug fixes
- Make
ARG002compatible withEM101when raisingNotImplementedError(#13714)
Other changes
- Introduce more Docker tags for Ruff (similar to uv) (#13274)
Contributors
- @Aditya-PS-05
- @AlexWaygood
- @Glyphack
- @Lexxxzy
- @MichaReiser
- @TomerBin
- @Watercycle
- @cake-monotone
- @carljm
- @dhruvmanila
- @diceroll123
- @mihaic
- @ndmitchell
- @pilleye
- @renovate
- @rtpg
- @samypr100
- @sharkdp
Install ruff 0.7.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.7.1/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.7.1/ruff-installer.ps1 | iex"Download ruff 0.7.1
0.7.0
Release Notes
Check out the blog post for a migration guide and overview of the changes!
Breaking changes
- The pytest rules
PT001andPT023now default to omitting the decorator parentheses when there are no arguments
(#12838, #13292).
This was a change that we attempted to make in Ruff v0.6.0, but only partially made due to an error on our part.
See the blog post for more details. - The
useless-try-exceptrule (in ourtryceratopscategory) has been recoded fromTRY302to
TRY203(#13502). This ensures Ruff's code is consistent with
the same rule in thetryceratopslinter. - The
lint.allow-unused-importssetting has been removed (#13677). Use
lint.pyflakes.allow-unused-imports
instead.
Formatter preview style
- Normalize implicit concatenated f-string quotes per part (#13539)
Preview linter features
- [
refurb] implementhardcoded-string-charset(FURB156) (#13530) - [
refurb] Count codepoints not bytes forslice-to-remove-prefix-or-suffix (FURB188)(#13631)
Rule changes
- [
pylint] MarkPLE1141fix as unsafe (#13629) - [
flake8-async] Consider async generators to be "checkpoints" forcancel-scope-no-checkpoint(ASYNC100) (#13639) - [
flake8-bugbear] Do not suggest setting parameterstrict=toFalseinB905diagnostic message (#13656) - [
flake8-todos] Only flag the word "TODO", not words starting with "todo" (TD006) (#13640) - [
pycodestyle] Fix whitespace-related false positives and false negatives inside type-parameter lists (E231,E251) (#13704) - [
flake8-simplify] Stabilize preview behavior forSIM115so that the rule can detect files
being opened from a wider range of standard-library functions (#12959).
CLI
- Add explanation of fixable in
--statisticscommand (#13774)
Bug fixes
- [
pyflakes] Allowipytestcell magic (F401) (#13745) - [
flake8-use-pathlib] FixPTH123false positive whenopenis passed a file descriptor (#13616) - [
flake8-bandit] Detect patterns from multi line SQL statements (S608) (#13574) - [
flake8-pyi] - Fix dropped expressions inPYI030autofix (#13727)
Contributors
- @AlexWaygood
- @DataEnggNerd
- @Lexxxzy
- @MichaReiser
- @Slyces
- @alex-700
- @autinerd
- @cake-monotone
- @carljm
- @dhruvmanila
- @diceroll123
- @dylwil3
- @github-actions
- @pilleye
- @qdegraaf
- @renovate
- @rtpg
- @sbrugman
- @sharkdp
- @zanieb
Install ruff 0.7.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.7.0/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.7.0/ruff-installer.ps1 | iex"Download ruff 0.7.0
0.6.9
Release Notes
Preview features
- Fix codeblock dynamic line length calculation for indented docstring examples (#13523)
- [
refurb] MarkFURB118fix as unsafe (#13613)
Rule changes
- [
pydocstyle] Don't raiseD208when last line is non-empty (#13372) - [
pylint] Preserve trivia (i.e. comments) inPLR5501autofix (#13573)
Configuration
- [
pyflakes] Addallow-unused-importssetting forunused-importrule (F401) (#13601)
Bug fixes
- Support ruff discovery in pip build environments (#13591)
- [
flake8-bugbear] Avoid short circuitingB017for multiple context managers (#13609) - [
pylint] Do not offer an invalid fix forPLR1716when the comparisons contain parenthesis (#13527) - [
pyupgrade] FixUP043to apply tocollections.abc.Generatorandcollections.abc.AsyncGenerator(#13611) - [
refurb] Fix handling of slices in tuples forFURB118, e.g.,x[:, 1](#13518)
Documentation
- Update GitHub Action link to
astral-sh/ruff-action(#13551)
Install ruff 0.6.9
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.6.9/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.6.9/ruff-installer.ps1 | iex"Download ruff 0.6.9
0.6.8
Release Notes
Preview features
- Remove unnecessary parentheses around
match caseclauses (#13510) - Parenthesize overlong
ifguards inmatch..caseclauses (#13513) - Detect basic wildcard imports in
ruff analyze graph(#13486) - [
pylint] Implementboolean-chained-comparison(R1716) (#13435)
Rule changes
- [
lake8-simplify] DetectSIM910when using variadic keyword arguments, i.e.,**kwargs(#13503) - [
pyupgrade] Avoid false negatives with non-reference shadowed bindings of loop variables (UP028) (#13504)
Bug fixes
- Detect tuples bound to variadic positional arguments i.e.
*args(#13512) - Exit gracefully on broken pipe errors (#13485)
- Avoid panic when analyze graph hits broken pipe (#13484)
Performance
Contributors
- @MichaReiser
- @TomerBin
- @charliermarsh
- @diceroll123
- @dylwil3
- @haarisr
- @renovate
- @sbrugman
- @vincevannoort
- @zanieb
Install ruff 0.6.8
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.6.8/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.6.8/ruff-installer.ps1 | iex"Download ruff 0.6.8
0.6.7
Release Notes
Preview features
- Add Python version support to ruff analyze CLI (#13426)
- Add
excludesupport toruff analyze(#13425) - Fix parentheses around return type annotations (#13381)
Rule changes
- [
pycodestyle] Fix: Don't autofix if the first line ends in a question mark? (D400) (#13399)
Bug fixes
- Respect
lint.excludein ruff check--add-noqa(#13427)
Performance
- Avoid tracking module resolver files in Salsa (#13437)
- Use
forgetfor module resolver database (#13438)
Install ruff 0.6.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.6.7/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/ruff/releases/download/0.6.7/ruff-installer.ps1 | iex"Download ruff 0.6.7
0.6.6
Release Notes
Preview features
- [
refurb] Skipslice-to-remove-prefix-or-suffix(FURB188) when non-trivial slice steps are present (#13405) - Add a subcommand to generate dependency graphs (#13402)
Formatter
- Fix placement of inline parameter comments (#13379)
Server
- Fix off-by one error in the
LineIndex::offsetcalculation (#13407)
Bug fixes
- [
fastapi] Respect FastAPI aliases in route definitions (#13394) - [
pydocstyle] Respect word boundaries when detecting function signature in docs (#13388)
Documentation
- Add backlinks to rule overview linter (#13368)
- Fix documentation for editor vim plugin ALE (#13348)
- Fix rendering of
FURB188docs (#13406)
Install ruff 0.6.6
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/astral-sh/ruff/releases/download/0.6.6/ruff-installer.sh | shInstall prebuilt binaries via powershell script
powershell -c "irm https://github.com/astral-sh/ruff/releases/download/0.6.6/ruff-installer.ps1 | iex"