Skip to content

Latest commit

 

History

History
2931 lines (2126 loc) · 207 KB

CHANGELOG.md

File metadata and controls

2931 lines (2126 loc) · 207 KB

Changelog

0.8.1

Preview features

  • Formatter: Avoid invalid syntax for format-spec with quotes for all Python versions (#14625)
  • Formatter: Consider quotes inside format-specs when choosing the quotes for an f-string (#14493)
  • Formatter: Do not consider f-strings with escaped newlines as multiline (#14624)
  • Formatter: Fix f-string formatting in assignment statement (#14454)
  • Formatter: Fix unnecessary space around power operator (**) in overlong f-string expressions (#14489)
  • [airflow] Avoid implicit schedule argument to DAG and @dag (AIR301) (#14581)
  • [flake8-builtins] Exempt private built-in modules (A005) (#14505)
  • [flake8-pytest-style] Fix pytest.mark.parametrize rules to check calls instead of decorators (#14515)
  • [flake8-type-checking] Implement runtime-cast-value (TC006) (#14511)
  • [flake8-type-checking] Implement unquoted-type-alias (TC007) and quoted-type-alias (TC008) (#12927)
  • [flake8-use-pathlib] Recommend Path.iterdir() over os.listdir() (PTH208) (#14509)
  • [pylint] Extend invalid-envvar-default to detect os.environ.get (PLW1508) (#14512)
  • [pylint] Implement len-test (PLC1802) (#14309)
  • [refurb] Fix bug where methods defined using lambdas were flagged by FURB118 (#14639)
  • [ruff] Auto-add r prefix when string has no backslashes for unraw-re-pattern (RUF039) (#14536)
  • [ruff] Implement invalid-assert-message-literal-argument (RUF040) (#14488)
  • [ruff] Implement unnecessary-nested-literal (RUF041) (#14323)
  • [ruff] Implement unnecessary-regular-expression (RUF055) (#14659)

Rule changes

  • Ignore more rules for stub files (#14541)
  • [pep8-naming] Eliminate false positives for single-letter names (N811, N814) (#14584)
  • [pyflakes] Avoid false positives in @no_type_check contexts (F821, F722) (#14615)
  • [ruff] Detect redirected-noqa in file-level comments (RUF101) (#14635)
  • [ruff] Mark fixes for unsorted-dunder-all and unsorted-dunder-slots as unsafe when there are complex comments in the sequence (RUF022, RUF023) (#14560)

Bug fixes

  • Avoid fixing code to None | None for redundant-none-literal (PYI061) and never-union (RUF020) (#14583, #14589)
  • [flake8-bugbear] Fix mutable-contextvar-default to resolve annotated function calls properly (B039) (#14532)
  • [flake8-pyi, ruff] Fix traversal of nested literals and unions (PYI016, PYI051, PYI055, PYI062, RUF041) (#14641)
  • [flake8-pyi] Avoid rewriting invalid type expressions in unnecessary-type-union (PYI055) (#14660)
  • [flake8-type-checking] Avoid syntax errors and type checking problem for quoted annotations autofix (TC003, TC006) (#14634)
  • [pylint] Do not wrap function calls in parentheses in the fix for unnecessary-dunder-call (PLC2801) (#14601)
  • [ruff] Handle attrs's auto_attribs correctly (RUF009) (#14520)

0.8.0

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-version or project.requires-python (#13896)

  • Changed location of pydoclint diagnostics

    pydoclint diagnostics 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 noqa comments in some places, this change may mean that you need to move the noqa suppression comments. Most users should be unaffected by this change.

  • Use XDG (i.e. ~/.local/bin) instead of the Cargo home directory in the standalone installer

    Previously, Ruff's installer used $CARGO_HOME or ~/.cargo/bin for 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:

Remapped rules

The following rules have been remapped to new rule codes:

Stabilization

The following rules have been stabilized and are no longer in preview:

The following behaviors have been stabilized:

The following fixes have been stabilized:

Preview features

  • [flake8-datetimez] Exempt min.time() and max.time() (DTZ901) (#14394)
  • [flake8-pie] Mark fix as unsafe if the following statement is a string literal (PIE790) (#14393)
  • [flake8-pyi] New rule redundant-none-literal (PYI061) (#14316)
  • [flake8-pyi] Add autofix for redundant-numeric-union (PYI041) (#14273)
  • [ruff] New rule map-int-version-parsing (RUF048) (#14373)
  • [ruff] New rule redundant-bool-literal (RUF038) (#14319)
  • [ruff] New rule unraw-re-pattern (RUF039) (#14446)
  • [pycodestyle] Exempt pytest.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.aliases only uses valid module names and aliases (#14477)

0.7.4

Preview features

  • [flake8-datetimez] Detect usages of datetime.max/datetime.min (DTZ901) (#14288)
  • [flake8-logging] Implement root-logger-calls (LOG015) (#14302)
  • [flake8-no-pep420] Detect empty implicit namespace packages (INP001) (#14236)
  • [flake8-pyi] Add "replace with Self" fix (PYI019) (#14238)
  • [perflint] Implement quick-fix for manual-list-comprehension (PERF401) (#13919)
  • [pylint] Implement shallow-copy-environ (W1507) (#14241)
  • [ruff] Implement none-not-at-end-of-union (RUF036) (#14314)
  • [ruff] Implementation unsafe-markup-call from flake8-markupsafe plugin (RUF035) (#14224)
  • [ruff] Report problems for attrs dataclasses (RUF008, RUF009) (#14327)

Rule changes

  • [flake8-boolean-trap] Exclude dunder methods that define operators (FBT001) (#14203)
  • [flake8-pyi] Add "replace with Self" fix (PYI034) (#14217)
  • [flake8-pyi] Always autofix duplicate-union-members (PYI016) (#14270)
  • [flake8-pyi] Improve autofix for nested and mixed type unions for unnecessary-type-union (PYI055) (#14272)
  • [flake8-pyi] Mark fix as unsafe when type annotation contains comments for duplicate-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) and I002 (missing-required-import) by considering lint.isort.required-imports for PLC014 (#14287)
  • [flake8-type-checking] Skip quoting annotation if it becomes invalid syntax (TCH001)
  • [flake8-pyi] Avoid using typing.Self in stub files pre-Python 3.11 (PYI034) (#14230)
  • [flake8-pytest-style] Flag pytest.raises call with keyword argument expected_exception (PT011) (#14298)
  • [flake8-simplify] Infer "unknown" truthiness for literal iterables whose items are all unpacks (SIM222) (#14263)
  • [flake8-type-checking] Fix false positives for typing.Annotated (TCH001) (#14311)
  • [pylint] Allow await at the top-level scope of a notebook (PLE1142) (#14225)
  • [pylint] Fix miscellaneous issues in await-outside-async detection (PLE1142) (#14218)
  • [pyupgrade] Avoid applying PEP 646 rewrites in invalid contexts (UP044) (#14234)
  • [pyupgrade] Detect permutations in redundant open modes (UP015) (#14255)
  • [refurb] Avoid triggering hardcoded-string-charset for reordered sets (FURB156) (#14233)
  • [refurb] Further special cases added to verbose-decimal-constructor (FURB157) (#14216)
  • [refurb] Use UserString instead of non-existent UserStr (FURB189) (#14209)
  • [ruff] Avoid treating lowercase letters as # noqa codes (RUF100) (#14229)
  • [ruff] Do not report when Optional has no type arguments (RUF013) (#14181)

Documentation

  • Add "Notebook behavior" section for F704, PLE1142 (#14266)
  • Document comment policy around fix safety (#14300)

0.7.3

Preview features

  • Formatter: Disallow single-line implicit concatenated strings (#13928)
  • [flake8-pyi] Include all Python file types for PYI006 and PYI066 (#14059)
  • [flake8-simplify] Implement split-of-static-string (SIM905) (#14008)
  • [refurb] Implement subclass-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 for docstring-in-stub (PYI021) (#14150)
  • [flake8-pyi] Update duplicate-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 run mutable-argument-default on stubs (B006) (#14058)
  • [flake8-builtins] Skip lambda expressions in builtin-argument-shadowing (A002) (#14144)
  • [flake8-comprehension] Also remove trailing comma while fixing C409 and C419 (#14097)
  • [flake8-simplify] Allow open without context manager in return statement (SIM115) (#14066)
  • [pylint] Respect hash-equivalent literals in iteration-over-set (PLC0208) (#14063)
  • [pylint] Update known dunder methods for Python 3.13 (PLW3201) (#14146)
  • [pyupgrade] - ignore kwarg unpacking for UP044 (#14053)
  • [refurb] Parse more exotic decimal strings in verbose-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)

0.7.2

Preview features

  • Fix formatting of single with-item with trailing comment (#14005)
  • [pyupgrade] Add PEP 646 Unpack conversion to * with fix (UP044) (#13988)

Rule changes

  • Regenerate known_stdlibs.rs with 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 for singledispatchmethod (TCH003) (#13941)
  • [flake8-type-checking] Treat return type of singledispatch as runtime-required (TCH003) (#13957)

Documentation

  • [flake8-simplify] Include caveats of enabling if-else-block-instead-of-if-exp (SIM108) (#14019)

0.7.1

Preview features

  • Fix E221 and E222 to 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] Restrict iteration-over-set to 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 ARG002 compatible with EM101 when raising NotImplementedError (#13714)

Other changes

  • Introduce more Docker tags for Ruff (similar to uv) (#13274)

0.7.0

Check out the blog post for a migration guide and overview of the changes!

Breaking changes

  • The pytest rules PT001 and PT023 now 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-except rule (in our tryceratops category) has been recoded from TRY302 to TRY203 (#13502). This ensures Ruff's code is consistent with the same rule in the tryceratops linter.
  • The lint.allow-unused-imports setting 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] implement hardcoded-string-charset (FURB156) (#13530)
  • [refurb] Count codepoints not bytes for slice-to-remove-prefix-or-suffix (FURB188) (#13631)

Rule changes

  • [pylint] Mark PLE1141 fix as unsafe (#13629)
  • [flake8-async] Consider async generators to be "checkpoints" for cancel-scope-no-checkpoint (ASYNC100) (#13639)
  • [flake8-bugbear] Do not suggest setting parameter strict= to False in B905 diagnostic 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 for SIM115 so that the rule can detect files being opened from a wider range of standard-library functions (#12959).

CLI

  • Add explanation of fixable in --statistics command (#13774)

Bug fixes

  • [pyflakes] Allow ipytest cell magic (F401) (#13745)
  • [flake8-use-pathlib] Fix PTH123 false positive when open is passed a file descriptor (#13616)
  • [flake8-bandit] Detect patterns from multi line SQL statements (S608) (#13574)
  • [flake8-pyi] - Fix dropped expressions in PYI030 autofix (#13727)

0.6.9

Preview features

  • Fix codeblock dynamic line length calculation for indented docstring examples (#13523)
  • [refurb] Mark FURB118 fix as unsafe (#13613)

Rule changes

  • [pydocstyle] Don't raise D208 when last line is non-empty (#13372)
  • [pylint] Preserve trivia (i.e. comments) in PLR5501 autofix (#13573)

Configuration

  • [pyflakes] Add allow-unused-imports setting for unused-import rule (F401) (#13601)

Bug fixes

  • Support ruff discovery in pip build environments (#13591)
  • [flake8-bugbear] Avoid short circuiting B017 for multiple context managers (#13609)
  • [pylint] Do not offer an invalid fix for PLR1716 when the comparisons contain parenthesis (#13527)
  • [pyupgrade] Fix UP043 to apply to collections.abc.Generator and collections.abc.AsyncGenerator (#13611)
  • [refurb] Fix handling of slices in tuples for FURB118, e.g., x[:, 1] (#13518)

Documentation

  • Update GitHub Action link to astral-sh/ruff-action (#13551)

0.6.8

Preview features

  • Remove unnecessary parentheses around match case clauses (#13510)
  • Parenthesize overlong if guards in match..case clauses (#13513)
  • Detect basic wildcard imports in ruff analyze graph (#13486)
  • [pylint] Implement boolean-chained-comparison (R1716) (#13435)

Rule changes

  • [lake8-simplify] Detect SIM910 when 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

  • Reuse BTreeSets in module resolver (#13440)
  • Skip traversal for non-compound statements (#13441)

0.6.7

Preview features

  • Add Python version support to ruff analyze CLI (#13426)
  • Add exclude support to ruff 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.exclude in ruff check --add-noqa (#13427)

Performance

  • Avoid tracking module resolver files in Salsa (#13437)
  • Use forget for module resolver database (#13438)

0.6.6

Preview features

  • [refurb] Skip slice-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::offset calculation (#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 FURB188 docs (#13406)

0.6.5

Preview features

  • [pydoclint] Ignore DOC201 when function name is "new" (#13300)
  • [refurb] Implement slice-to-remove-prefix-or-suffix (FURB188) (#13256)

Rule changes

  • [eradicate] Ignore script-comments with multiple end-tags (ERA001) (#13283)
  • [pyflakes] Improve error message for UndefinedName when a builtin was added in a newer version than specified in Ruff config (F821) (#13293)

Server

  • Add support for extensionless Python files for server (#13326)
  • Fix configuration inheritance for configurations specified in the LSP settings (#13285)

Bug fixes

  • [ruff] Handle unary operators in decimal-from-float-literal (RUF032) (#13275)

CLI

  • Only include rules with diagnostics in SARIF metadata (#13268)

Playground

  • Add "Copy as pyproject.toml/ruff.toml" and "Paste from TOML" (#13328)
  • Fix errors not shown for restored snippet on page load (#13262)

0.6.4

Preview features

  • [flake8-builtins] Use dynamic builtins list based on Python version (#13172)
  • [pydoclint] Permit yielding None in DOC402 and DOC403 (#13148)
  • [pylint] Update diagnostic message for PLW3201 (#13194)
  • [ruff] Implement post-init-default (RUF033) (#13192)
  • [ruff] Implement useless if-else (RUF034) (#13218)

Rule changes

  • [flake8-pyi] Respect pep8_naming.classmethod-decorators settings when determining if a method is a classmethod in custom-type-var-return-type (PYI019) (#13162)
  • [flake8-pyi] Teach various rules that annotations might be stringized (#12951)
  • [pylint] Avoid no-self-use for attrs-style validators (#13166)
  • [pylint] Recurse into subscript subexpressions when searching for list/dict lookups (PLR1733, PLR1736) (#13186)
  • [pyupgrade] Detect aiofiles.open calls in UP015 (#13173)
  • [pyupgrade] Mark sys.version_info[0] < 3 and similar comparisons as outdated (UP036) (#13175)

CLI

  • Enrich messages of SARIF results (#13180)
  • Handle singular case for incompatible rules warning in ruff format output (#13212)

Bug fixes

  • [pydocstyle] Improve heuristics for detecting Google-style docstrings (#13142)
  • [refurb] Treat sep arguments with effects as unsafe removals (FURB105) (#13165)

0.6.3

Preview features

  • [flake8-simplify] Extend open-file-with-context-handler to work with dbm.sqlite3 (SIM115) (#13104)
  • [pycodestyle] Disable E741 in stub files (.pyi) (#13119)
  • [pydoclint] Avoid DOC201 on explicit returns in functions that only return None (#13064)

Rule changes

  • [flake8-async] Disable check for asyncio before Python 3.11 (ASYNC109) (#13023)

Bug fixes

  • [FastAPI] Avoid introducing invalid syntax in fix for fast-api-non-annotated-dependency (FAST002) (#13133)
  • [flake8-implicit-str-concat] Normalize octals before merging concatenated strings in single-line-implicit-string-concatenation (ISC001) (#13118)
  • [flake8-pytest-style] Improve help message for pytest-incorrect-mark-parentheses-style (PT023) (#13092)
  • [pylint] Avoid autofix for calls that aren't min or max as starred expression (PLW3301) (#13089)
  • [ruff] Add datetime.time, datetime.tzinfo, and datetime.timezone as immutable function calls (RUF009) (#13109)
  • [ruff] Extend comment deletion for RUF100 to include trailing text from noqa directives while preserving any following comments on the same line, if any (#13105)
  • Fix dark theme on initial page load for the Ruff playground (#13077)

0.6.2

Preview features

  • [flake8-simplify] Extend open-file-with-context-handler to work with other standard-library IO modules (SIM115) (#12959)
  • [ruff] Avoid unused-async for functions with FastAPI route decorator (RUF029) (#12938)
  • [ruff] Ignore fstring-missing-syntax (RUF027) for fastAPI paths (#12939)
  • [ruff] Implement check for Decimal called with a float literal (RUF032) (#12909)

Rule changes

  • [flake8-bugbear] Update diagnostic message when expression is at the end of function (B015) (#12944)
  • [flake8-pyi] Skip type annotations in string-or-bytes-too-long (PYI053) (#13002)
  • [flake8-type-checking] Always recognise relative imports as first-party (#12994)
  • [flake8-unused-arguments] Ignore unused arguments on stub functions (ARG001) (#12966)
  • [pylint] Ignore augmented assignment for self-cls-assignment (PLW0642) (#12957)

Server

  • Show full context in error log messages (#13029)

Bug fixes

  • [pep8-naming] Don't flag from imports following conventional import names (N817) (#12946)
  • [pylint] - Allow __new__ methods to have cls as their first argument even if decorated with @staticmethod for bad-staticmethod-argument (PLW0211) (#12958)

Documentation

  • Add hyperfine installation instructions; update hyperfine code samples (#13034)
  • Expand note to use Ruff with other language server in Kate (#12806)
  • Update example for PT001 as per the new default behavior (#13019)
  • [perflint] Improve docs for try-except-in-loop (PERF203) (#12947)
  • [pydocstyle] Add reference to lint.pydocstyle.ignore-decorators setting to rule docs (#12996)

0.6.1

This is a hotfix release to address an issue with ruff-pre-commit. In v0.6, Ruff changed its behavior to lint and format Jupyter notebooks by default; however, due to an oversight, these files were still excluded by default if Ruff was run via pre-commit, leading to inconsistent behavior. This has now been fixed.

Preview features

  • [fastapi] Implement fast-api-unused-path-parameter (FAST003) (#12638)

Rule changes

  • [pylint] Rename too-many-positional to too-many-positional-arguments (R0917) (#12905)

Server

  • Fix crash when applying "fix-all" code-action to notebook cells (#12929)

Other changes

  • [flake8-naming]: Respect import conventions (N817) (#12922)

0.6.0

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.

  • Lint and format Jupyter Notebook by default (#12878).
  • Detect imports in src layouts by default for isort rules (#12848)
  • The pytest rules PT001 and PT023 now default to omitting the decorator parentheses when there are no arguments (#12838).

Deprecations

The following rules are now deprecated:

Remapped rules

The following rules have been remapped to new rule codes:

Stabilization

The following rules have been stabilized and are no longer in preview:

The following behaviors have been stabilized:

The following fixes have been stabilized:

Preview features

  • [flake8-simplify] Further simplify to binary in preview for (SIM108) (#12796)
  • [pyupgrade] Show violations without auto-fix (UP031) (#11229)

Rule changes

  • [flake8-import-conventions] Add xml.etree.ElementTree to default conventions (#12455)
  • [flake8-pytest-style] Add a space after comma in CSV output (PT006) (#12853)

Server

  • Show a message for incorrect settings (#12781)

Bug fixes

  • [flake8-async] Do not lint yield in context manager (ASYNC100) (#12896)
  • [flake8-comprehensions] Do not lint async for comprehensions (C419) (#12895)
  • [flake8-return] Only add return None at end of a function (RET503) (#11074)
  • [flake8-type-checking] Avoid treating dataclasses.KW_ONLY as typing-only (TCH003) (#12863)
  • [pep8-naming] Treat type(Protocol) et al as metaclass base (N805) (#12770)
  • [pydoclint] Don't enforce returns and yields in abstract methods (DOC201, DOC202) (#12771)
  • [ruff] Skip tuples with slice expressions in (RUF031) (#12768)
  • [ruff] Ignore unparenthesized tuples in subscripts when the subscript is a type annotation or type alias (RUF031) (#12762)
  • [ruff] Ignore template strings passed to logging and builtins._() calls (RUF027) (#12889)
  • [ruff] Do not remove parens for tuples with starred expressions in Python <=3.10 (RUF031) (#12784)
  • Evaluate default parameter values for a function in that function's enclosing scope (#12852)

Other changes

  • Respect VS Code cell metadata when detecting the language of Jupyter Notebook cells (#12864)
  • Respect kernelspec notebook metadata when detecting the preferred language for a Jupyter Notebook (#12875)

0.5.7

Preview features

  • [flake8-comprehensions] Account for list and set comprehensions in unnecessary-literal-within-tuple-call (C409) (#12657)
  • [flake8-pyi] Add autofix for future-annotations-in-stub (PYI044) (#12676)
  • [flake8-return] Avoid syntax error when auto-fixing RET505 with mixed indentation (space and tabs) (#12740)
  • [pydoclint] Add docstring-missing-yields (DOC402) and docstring-extraneous-yields (DOC403) (#12538)
  • [pydoclint] Avoid DOC201 if docstring begins with "Return", "Returns", "Yield", or "Yields" (#12675)
  • [pydoclint] Deduplicate collected exceptions after traversing function bodies (DOC501) (#12642)
  • [pydoclint] Ignore DOC errors for stub functions (#12651)
  • [pydoclint] Teach rules to understand reraised exceptions as being explicitly raised (DOC501, DOC502) (#12639)
  • [ruff] Implement incorrectly-parenthesized-tuple-in-subscript (RUF031) (#12480)
  • [ruff] Mark RUF023 fix as unsafe if __slots__ is not a set and the binding is used elsewhere (#12692)

Rule changes

  • [refurb] Add autofix for implicit-cwd (FURB177) (#12708)
  • [ruff] Add autofix for zip-instead-of-pairwise (RUF007) (#12663)
  • [tryceratops] Add BaseException to raise-vanilla-class rule (TRY002) (#12620)

Server

  • Ignore non-file workspace URL; Ruff will display a warning notification in this case (#12725)

CLI

  • Fix cache invalidation for nested pyproject.toml files (#12727)

Bug fixes

  • [flake8-async] Fix false positives with multiple async with items (ASYNC100) (#12643)
  • [flake8-bandit] Avoid false-positives for list concatenations in SQL construction (S608) (#12720)
  • [flake8-bugbear] Treat return as equivalent to break (B909) (#12646)
  • [flake8-comprehensions] Set comprehensions not a violation for sum in unnecessary-comprehension-in-call (C419) (#12691)
  • [flake8-simplify] Parenthesize conditions based on precedence when merging if arms (SIM114) (#12737)
  • [pydoclint] Try both 'Raises' section styles when convention is unspecified (DOC501) (#12649)

0.5.6

Ruff 0.5.6 automatically enables linting and formatting of notebooks in preview mode. You can opt-out of this behavior by adding *.ipynb to the extend-exclude setting.

[tool.ruff]
extend-exclude = ["*.ipynb"]

Preview features

  • Enable notebooks by default in preview mode (#12621)
  • [flake8-builtins] Implement import, lambda, and module shadowing (#12546)
  • [pydoclint] Add docstring-missing-returns (DOC201) and docstring-extraneous-returns (DOC202) (#12485)

Rule changes

  • [flake8-return] Exempt cached properties and other property-like decorators from explicit return rule (RET501) (#12563)

Server

  • Make server panic hook more error resilient (#12610)
  • Use $/logTrace for server trace logs in Zed and VS Code (#12564)
  • Keep track of deleted cells for reorder change request (#12575)

Configuration

  • [flake8-implicit-str-concat] Always allow explicit multi-line concatenations when implicit concatenations are banned (#12532)

Bug fixes

  • [flake8-async] Avoid flagging asyncio.timeouts as unused when the context manager includes asyncio.TaskGroup (#12605)
  • [flake8-slots] Avoid recommending __slots__ for classes that inherit from more than namedtuple (#12531)
  • [isort] Avoid marking required imports as unused (#12537)
  • [isort] Preserve trailing inline comments on import-from statements (#12498)
  • [pycodestyle] Add newlines before comments (E305) (#12606)
  • [pycodestyle] Don't attach comments with mismatched indents (#12604)
  • [pyflakes] Fix preview-mode bugs in F401 when attempting to autofix unused first-party submodule imports in an __init__.py file (#12569)
  • [pylint] Respect start index in unnecessary-list-index-lookup (#12603)
  • [pyupgrade] Avoid recommending no-argument super in slots=True dataclasses (#12530)
  • [pyupgrade] Use colon rather than dot formatting for integer-only types (#12534)
  • Fix NFKC normalization bug when removing unused imports (#12571)

Other changes

  • Consider more stdlib decorators to be property-like (#12583)
  • Improve handling of metaclasses in various linter rules (#12579)
  • Improve consistency between linter rules in determining whether a function is property (#12581)

0.5.5

Preview features

  • [fastapi] Implement fastapi-redundant-response-model (FAST001) and fastapi-non-annotated-dependency(FAST002) (#11579)
  • [pydoclint] Implement docstring-missing-exception (DOC501) and docstring-extraneous-exception (DOC502) (#11471)

Rule changes

  • [numpy] Fix NumPy 2.0 rule for np.alltrue and np.sometrue (#12473)
  • [numpy] Ignore NPY201 inside except blocks for compatibility with older numpy versions (#12490)
  • [pep8-naming] Avoid applying ignore-names to self and cls function names (N804, N805) (#12497)

Formatter

  • Fix incorrect placement of leading function comment with type params (#12447)

Server

  • Do not bail code action resolution when a quick fix is requested (#12462)

Bug fixes

  • Fix Ord implementation of cmp_fix (#12471)
  • Raise syntax error for unparenthesized generator expression in multi-argument call (#12445)
  • [pydoclint] Fix panic in DOC501 reported in #12428 (#12435)
  • [flake8-bugbear] Allow singleton tuples with starred expressions in B013 (#12484)

Documentation

  • Add Eglot setup guide for Emacs editor (#12426)
  • Add note about the breaking change in nvim-lspconfig (#12507)
  • Add note to include notebook files for native server (#12449)
  • Add setup docs for Zed editor (#12501)

0.5.4

Rule changes

  • [ruff] Rename RUF007 to zip-instead-of-pairwise (#12399)

Bug fixes

  • [flake8-builtins] Avoid shadowing diagnostics for @override methods (#12415)
  • [flake8-comprehensions] Insert parentheses for multi-argument generators (#12422)
  • [pydocstyle] Handle escaped docstrings within docstring (D301) (#12192)

Documentation

  • Fix GitHub link to Neovim setup (#12410)
  • Fix output-format default in settings reference (#12409)

0.5.3

Ruff 0.5.3 marks the stable release of the Ruff language server and introduces revamped documentation, including setup guides for your editor of choice and the language server itself.

Preview features

  • Formatter: Insert empty line between suite and alternative branch after function/class definition (#12294)
  • [pyupgrade] Implement unnecessary-default-type-args (UP043) (#12371)

Rule changes

  • [flake8-bugbear] Detect enumerate iterations in loop-iterator-mutation (B909) (#12366)
  • [flake8-bugbear] Remove discard, remove, and pop allowance for loop-iterator-mutation (B909) (#12365)
  • [pylint] Allow repeated-equality-comparison for mixed operations (PLR1714) (#12369)
  • [pylint] Ignore self and cls when counting arguments (PLR0913) (#12367)
  • [pylint] Use UTF-8 as default encoding in unspecified-encoding fix (PLW1514) (#12370)

Server

  • Build settings index in parallel for the native server (#12299)
  • Use fallback settings when indexing the project (#12362)
  • Consider --preview flag for server subcommand for the linter and formatter (#12208)

Bug fixes

  • [flake8-comprehensions] Allow additional arguments for sum and max comprehensions (C419) (#12364)
  • [pylint] Avoid dropping extra boolean operations in repeated-equality-comparison (PLR1714) (#12368)
  • [pylint] Consider expression before statement when determining binding kind (PLR1704) (#12346)

Documentation

  • Add docs for Ruff language server (#12344)
  • Migrate to standalone docs repo (#12341)
  • Update versioning policy for editor integration (#12375)

Other changes

  • Publish Wasm API to npm (#12317)

0.5.2

Preview features

  • Use space separator before parenthesized expressions in comprehensions with leading comments (#12282)
  • [flake8-async] Update ASYNC100 to include anyio and asyncio (#12221)
  • [flake8-async] Update ASYNC109 to include anyio and asyncio (#12236)
  • [flake8-async] Update ASYNC110 to include anyio and asyncio (#12261)
  • [flake8-async] Update ASYNC115 to include anyio and asyncio (#12262)
  • [flake8-async] Update ASYNC116 to include anyio and asyncio (#12266)

Rule changes

  • [flake8-return] Exempt properties from explicit return rule (RET501) (#12243)
  • [numpy] Add np.NAN-to-np.nan diagnostic (#12292)
  • [refurb] Make list-reverse-copy an unsafe fix (#12303)

Server

  • Consider include and extend-include settings in native server (#12252)
  • Include nested configurations in settings reloading (#12253)

CLI

  • Omit code frames for fixes with empty ranges (#12304)
  • Warn about formatter incompatibility for D203 (#12238)

Bug fixes

  • Make cache-write failures non-fatal on Windows (#12302)
  • Treat not operations as boolean tests (#12301)
  • [flake8-bandit] Avoid S310 violations for HTTP-safe f-strings (#12305)
  • [flake8-bandit] Support explicit string concatenations in S310 HTTP detection (#12315)
  • [flake8-bandit] fix S113 false positive for httpx without timeout argument (#12213)
  • [pycodestyle] Remove "non-obvious" allowance for E721 (#12300)
  • [pyflakes] Consider with blocks as single-item branches for redefinition analysis (#12311)
  • [refurb] Restrict forwarding for newline argument in open() calls to Python versions >= 3.10 (#12244)

Documentation

  • Update help and documentation to reflect --output-format full default (#12248)

Performance

  • Use more threads when discovering Python files (#12258)

0.5.1

Preview features

  • [flake8-bugbear] Implement mutable-contextvar-default (B039) (#12113)
  • [pycodestyle] Whitespace after decorator (E204) (#12140)
  • [pytest] Reverse PT001 and PT0023 defaults (#12106)

Rule changes

  • Enable token-based rules on source with syntax errors (#11950)
  • [flake8-bandit] Detect httpx for S113 (#12174)
  • [numpy] Update NPY201 to include exception deprecations (#12065)
  • [pylint] Generate autofix for duplicate-bases (PLE0241) (#12105)

Server

  • Avoid syntax error notification for source code actions (#12148)
  • Consider the content of the new cells during notebook sync (#12203)
  • Fix replacement edit range computation (#12171)

Bug fixes

  • Disable auto-fix when source has syntax errors (#12134)
  • Fix cache key collisions for paths with separators (#12159)
  • Make requires-python inference robust to == (#12091)
  • Use char-wise width instead of str-width (#12135)
  • [pycodestyle] Avoid E275 if keyword followed by comma (#12136)
  • [pycodestyle] Avoid E275 if keyword is followed by a semicolon (#12095)
  • [pylint] Skip dummy variables for PLR1704 (#12190)

Performance

  • Remove allocation in parse_identifier (#12103)
  • Use CompactString for Identifier AST node (#12101)

0.5.0

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.

  • Follow the XDG specification to discover user-level configurations on macOS (same as on other Unix platforms)
  • Selecting ALL now excludes deprecated rules
  • The released archives now include an extra level of nesting, which can be removed with --strip-components=1 when untarring.
  • The release artifact's file name no longer includes the version tag. This enables users to install via /latest URLs on GitHub.
  • The diagnostic ranges for some flake8-bandit rules were modified (#10667).

Deprecations

The following rules are now deprecated:

Remapped rules

The following rules have been remapped to new rule codes:

Stabilization

The following rules have been stabilized and are no longer in preview:

The following behaviors have been stabilized:

Removals

The following deprecated settings have been removed:

  • output-format=text; use output-format=concise or output-format=full
  • tab-size; use indent-width

The following deprecated CLI options have been removed:

  • --show-source; use --output-format=full
  • --no-show-source; use --output-format=concise

The following deprecated CLI commands have been removed:

  • ruff <path>; use ruff check <path>
  • ruff --clean; use ruff clean
  • ruff --generate-shell-completion; use ruff generate-shell-completion

Preview features

  • [ruff] Add assert-with-print-message rule (#11981)

CLI

  • Use rule name rather than message in --statistics (#11697)
  • Use the output format full by default (#12010)
  • Don't log syntax errors to the console (#11902)

Rule changes

  • [ruff] Fix false positives if gettext is imported using an alias (RUF027) (#12025)
  • [numpy] Update trapz and in1d deprecation (NPY201) (#11948)
  • [flake8-bandit] Modify diagnostic ranges for shell-related rules (#10667)

Server

  • Closing an untitled, unsaved notebook document no longer throws an error (#11942)
  • Support the usage of tildes and environment variables in logFile (#11945)
  • Add option to configure whether to show syntax errors (#12059)

Bug fixes

  • [pycodestyle] Avoid E203 for f-string debug expression (#12024)
  • [pep8-naming] Match import-name ignores against both name and alias (N812, N817) (#12033)
  • [pyflakes] Detect assignments that shadow definitions (F811) (#11961)

Parser

  • Emit a syntax error for an empty type parameter list (#12030)
  • Avoid consuming the newline for unterminated strings (#12067)
  • Do not include the newline in the unterminated string range (#12017)
  • Use the correct range to highlight line continuation errors (#12016)
  • Consider 2-character EOL before line continuations (#12035)
  • Consider line continuation character for re-lexing (#12008)

Other changes

  • Upgrade the Unicode table used for measuring the line-length (#11194)
  • Remove the deprecation error message for the nursery selector (#10172)

0.4.10

Parser

  • Implement re-lexing logic for better error recovery (#11845)

Rule changes

  • [flake8-copyright] Update CPY001 to check the first 4096 bytes instead of 1024 (#11927)
  • [pycodestyle] Update E999 to show all syntax errors instead of just the first one (#11900)

Server

  • Add tracing setup guide to Helix documentation (#11883)
  • Add tracing setup guide to Neovim documentation (#11884)
  • Defer notebook cell deletion to avoid an error message (#11864)

Security

  • Guard against malicious ecosystem comment artifacts (#11879)

0.4.9

Preview features

  • [pylint] Implement consider-dict-items (C0206) (#11688)
  • [refurb] Implement repeated-global (FURB154) (#11187)

Rule changes

  • [pycodestyle] Adapt fix for E203 to work identical to ruff format (#10999)

Formatter

  • Fix formatter instability for lines only consisting of zero-width characters (#11748)

Server

  • Add supported commands in server capabilities (#11850)
  • Use real file path when available in ruff server (#11800)
  • Improve error message when a command is run on an unavailable document (#11823)
  • Introduce the ruff.printDebugInformation command (#11831)
  • Tracing system now respects log level and trace level, with options to log to a file (#11747)

CLI

  • Handle non-printable characters in diff view (#11687)

Bug fixes

  • [refurb] Avoid suggesting starmap when arguments are used outside call (FURB140) (#11830)
  • [flake8-bugbear] Avoid panic in B909 when checking large loop blocks (#11772)
  • [refurb] Fix misbehavior of operator.itemgetter when getter param is a tuple (FURB118) (#11774)

0.4.8

Performance

  • Linter performance has been improved by around 10% on some microbenchmarks by refactoring the lexer and parser to maintain synchronicity between them (#11457)

Preview features

  • [flake8-bugbear] Implement return-in-generator (B901) (#11644)
  • [flake8-pyi] Implement pep484-style-positional-only-parameter (PYI063) (#11699)
  • [pygrep_hooks] Check blanket ignores via file-level pragmas (PGH004) (#11540)

Rule changes

  • [pyupgrade] Update UP035 for Python 3.13 and the latest version of typing_extensions (#11693)
  • [numpy] Update NPY001 rule for NumPy 2.0 (#11735)

Server

  • Formatting a document with syntax problems no longer spams a visible error popup (#11745)

CLI

  • Add RDJson support for --output-format flag (#11682)

Bug fixes

  • [pyupgrade] Write empty string in lieu of panic when fixing UP032 (#11696)
  • [flake8-simplify] Simplify double negatives in SIM103 (#11684)
  • Ensure the expression generator adds a newline before type statements (#11720)
  • Respect per-file ignores for blanket and redirected noqa rules (#11728)

0.4.7

Preview features

  • [flake8-pyi] Implement PYI064 (#11325)
  • [flake8-pyi] Implement PYI066 (#11541)
  • [flake8-pyi] Implement PYI057 (#11486)
  • [pyflakes] Enable F822 in __init__.py files by default (#11370)

Formatter

  • Fix incorrect placement of trailing stub function comments (#11632)

Server

  • Respect file exclusions in ruff server (#11590)
  • Add support for documents not exist on disk (#11588)
  • Add Vim and Kate setup guide for ruff server (#11615)

Bug fixes

  • Avoid removing newlines between docstring headers and rST blocks (#11609)
  • Infer indentation with imports when logical indent is absent (#11608)
  • Use char index rather than position for indent slice (#11645)
  • [flake8-comprehension] Strip parentheses around generators in C400 (#11607)
  • Mark repeated-isinstance-calls as unsafe on Python 3.10 and later (#11622)

0.4.6

Breaking changes

  • Use project-relative paths when calculating GitLab fingerprints (#11532)
  • Bump minimum supported Windows version to Windows 10 (#11613)

Preview features

  • [flake8-async] Sleep with >24 hour interval should usually sleep forever (ASYNC116) (#11498)

Rule changes

  • [numpy] Add missing functions to NumPy 2.0 migration rule (#11528)
  • [mccabe] Consider irrefutable pattern similar to if .. else for C901 (#11565)
  • Consider match-case statements for C901, PLR0912, and PLR0915 (#11521)
  • Remove empty strings when converting to f-string (UP032) (#11524)
  • [flake8-bandit] request-without-timeout should warn for requests.request (#11548)
  • [flake8-self] Ignore sunder accesses in flake8-self rules (#11546)
  • [pyupgrade] Lint for TypeAliasType usages (UP040) (#11530)

Server

  • Respect excludes in ruff server configuration discovery (#11551)
  • Use default settings if initialization options is empty or not provided (#11566)
  • ruff server correctly treats .pyi files as stub files (#11535)
  • ruff server searches for configuration in parent directories (#11537)
  • ruff server: An empty code action filter no longer returns notebook source actions (#11526)

Bug fixes

  • [flake8-logging-format] Fix autofix title in logging-warn (G010) (#11514)
  • [refurb] Avoid recommending operator.itemgetter with dependence on lambda arguments (#11574)
  • [flake8-simplify] Avoid recommending context manager in __enter__ implementations (#11575)
  • Create intermediary directories for --output-file (#11550)
  • Propagate reads on global variables (#11584)
  • Treat all singledispatch arguments as runtime-required (#11523)

0.4.5

Ruff's language server is now in Beta

v0.4.5 marks the official Beta release of ruff server, an integrated language server built into Ruff. 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!

You can enable ruff server in the VS Code extension today.

To read more about this exciting milestone, check out our blog post!

Rule changes

  • [flake8-future-annotations] Reword future-rewritable-type-annotation (FA100) message (#11381)
  • [isort] Expanded the set of standard-library modules to include _string, etc. (#11374)
  • [pycodestyle] Consider soft keywords for E27 rules (#11446)
  • [pyflakes] Recommend adding unused import bindings to __all__ (#11314)
  • [pyflakes] Update documentation and deprecate ignore_init_module_imports (#11436)
  • [pyupgrade] Mark quotes as unnecessary for non-evaluated annotations (#11485)

Formatter

  • Avoid multiline quotes warning with quote-style = preserve (#11490)

Server

  • Support Jupyter Notebook files (#11206)
  • Support noqa comment code actions (#11276)
  • Fix automatic configuration reloading (#11492)
  • Fix several issues with configuration in Neovim and Helix (#11497)

CLI

  • Add --output-format as a CLI option for ruff config (#11438)

Bug fixes

  • Avoid PLE0237 for property with setter (#11377)
  • Avoid TCH005 for if stmt with elif/else block (#11376)
  • Avoid flagging __future__ annotations as required for non-evaluated type annotations (#11414)
  • Check for ruff executable in 'bin' directory as installed by 'pip install --target'. (#11450)
  • Sort edits prior to deduplicating in quotation fix (#11452)
  • Treat escaped newline as valid sequence (#11465)
  • [flake8-pie] Preserve parentheses in unnecessary-dict-kwargs (#11372)
  • [pylint] Ignore __slots__ with dynamic values (#11488)
  • [pylint] Remove try body from branch counting (#11487)
  • [refurb] Respect operator precedence in FURB110 (#11464)

Documentation

  • Add --preview to the README (#11395)
  • Add Python 3.13 to list of allowed Python versions (#11411)
  • Simplify Neovim setup documentation (#11489)
  • Update CONTRIBUTING.md to reflect the new parser (#11434)
  • Update server documentation with new migration guide (#11499)
  • [pycodestyle] Clarify motivation for E713 and E714 (#11483)
  • [pyflakes] Update docs to describe WAI behavior (F541) (#11362)
  • [pylint] Clearly indicate what is counted as a branch (#11423)

0.4.4

Preview features

  • [pycodestyle] Ignore end-of-line comments when determining blank line rules (#11342)
  • [pylint] Detect pathlib.Path.open calls in unspecified-encoding (PLW1514) (#11288)
  • [flake8-pyi] Implement PYI059 (generic-not-last-base-class) (#11233)
  • [flake8-pyi] Implement PYI062 (duplicate-literal-member) (#11269)

Rule changes

  • [flake8-boolean-trap] Allow passing booleans as positional-only arguments in code such as set(True) (#11287)
  • [flake8-bugbear] Ignore enum classes in cached-instance-method (B019) (#11312)

Server

  • Expand tildes when resolving Ruff server configuration file (#11283)
  • Fix ruff server hanging after Neovim closes (#11291)
  • Editor settings are used by default if no file-based configuration exists (#11266)

Bug fixes

  • [pylint] Consider with statements for too-many-branches (PLR0912) (#11321)
  • [flake8-blind-except, tryceratops] Respect logged and re-raised expressions in nested statements (BLE001, TRY201) (#11301)
  • Recognise assignments such as __all__ = builtins.list(["foo", "bar"]) as valid __all__ definitions (#11335)

0.4.3

Enhancements

  • Add support for PEP 696 syntax (#11120)

Preview features

  • [refurb] Use function range for reimplemented-operator diagnostics (#11271)
  • [refurb] Ignore methods in reimplemented-operator (FURB118) (#11270)
  • [refurb] Implement fstring-number-format (FURB116) (#10921)
  • [ruff] Implement redirected-noqa (RUF101) (#11052)
  • [pyflakes] Distinguish between first-party and third-party imports for fix suggestions (#11168)

Rule changes

  • [flake8-bugbear] Ignore non-abstract class attributes when enforcing B024 (#11210)
  • [flake8-logging] Include inline instantiations when detecting loggers (#11154)
  • [pylint] Also emit PLR0206 for properties with variadic parameters (#11200)
  • [ruff] Detect duplicate codes as part of unused-noqa (RUF100) (#10850)

Formatter

  • Avoid multiline expression if format specifier is present (#11123)

LSP

  • Write ruff server setup guide for Helix (#11183)
  • ruff server no longer hangs after shutdown (#11222)
  • ruff server reads from a configuration TOML file in the user configuration directory if no local configuration exists (#11225)
  • ruff server respects per-file-ignores configuration (#11224)
  • ruff server: Support a custom TOML configuration file (#11140)
  • ruff server: Support setting to prioritize project configuration over editor configuration (#11086)

Bug fixes

  • Avoid debug assertion around NFKC renames (#11249)
  • [pyflakes] Prioritize redefined-while-unused over unused-import (#11173)
  • [ruff] Respect async expressions in comprehension bodies (#11219)
  • [pygrep_hooks] Fix blanket-noqa panic when last line has noqa with no newline (PGH004) (#11108)
  • [perflint] Ignore list-copy recommendations for async for loops (#11250)
  • [pyflakes] Improve invalid-print-syntax documentation (#11171)

Performance

  • Avoid allocations for isort module names (#11251)
  • Build a separate ARM wheel for macOS (#11149)

Windows

  • Increase the minimum requirement to Windows 10.

0.4.2

Rule changes

  • [flake8-pyi] Allow for overloaded __exit__ and __aexit__ definitions (PYI036) (#11057)
  • [pyupgrade] Catch usages of "%s" % var and provide an unsafe fix (UP031) (#11019)
  • [refurb] Implement new rule that suggests min/max over sorted() (FURB192) (#10868)

Server

  • Fix an issue with missing diagnostics for Neovim and Helix (#11092)
  • Implement hover documentation for noqa codes (#11096)
  • Introduce common Ruff configuration options with new server settings (#11062)

Bug fixes

  • Use macos-12 for building release wheels to enable macOS 11 compatibility (#11146)
  • [flake8-blind-expect] Allow raise from in BLE001 (#11131)
  • [flake8-pyi] Allow simple assignments to None in enum class scopes (PYI026) (#11128)
  • [flake8-simplify] Avoid raising SIM911 for non-zip attribute calls (#11126)
  • [refurb] Avoid operator.itemgetter suggestion for single-item tuple (#11095)
  • [ruff] Respect per-file-ignores for RUF100 with no other diagnostics (#11058)
  • [ruff] Fix async comprehension false positive (RUF029) (#11070)

Documentation

  • [flake8-bugbear] Document explicitly disabling strict zip (B905) (#11040)
  • [flake8-type-checking] Mention lint.typing-modules in TCH001, TCH002, and TCH003 (#11144)
  • [isort] Improve documentation around custom isort sections (#11050)
  • [pylint] Fix documentation oversight for invalid-X-returns (#11094)

Performance

  • Use matchit to resolve per-file settings (#11111)

0.4.1

Preview features

  • [pylint] Implement invalid-hash-returned (PLE0309) (#10961)
  • [pylint] Implement invalid-index-returned (PLE0305) (#10962)

Bug fixes

  • [pylint] Allow NoReturn-like functions for __str__, __len__, etc. (PLE0307) (#11017)
  • Parser: Use empty range when there's "gap" in token source (#11032)
  • [ruff] Ignore stub functions in unused-async (RUF029) (#11026)
  • Parser: Expect indented case block instead of match stmt (#11033)

0.4.0

A new, hand-written parser

Ruff's new parser is >2x faster, which translates to a 20-40% speedup for all linting and formatting invocations. There's a lot to say about this exciting change, so check out the blog post for more details!

See #10036 for implementation details.

A new language server in Rust

With this release, we also want to highlight our new language server. ruff server is a Rust-powered language server that comes built-in with Ruff. It can be used with any editor that supports the Language Server Protocol (LSP). It uses a multi-threaded, lock-free architecture inspired by rust-analyzer and it will open the door for a lot of exciting features. It’s also faster than our previous Python-based language server -- but you probably guessed that already.

ruff server is only in alpha, but it has a lot of features that you can try out today:

  • Lints Python files automatically and shows quick-fixes when available
  • Formats Python files, with support for range formatting
  • Comes with commands for quickly performing actions: ruff.applyAutofix, ruff.applyFormat, and ruff.applyOrganizeImports
  • Supports source.fixAll and source.organizeImports source actions
  • Automatically reloads your project configuration when you change it

To setup ruff server with your editor, refer to the README.md.

Preview features

  • [pycodestyle] Do not trigger E3 rules on defs following a function/method with a dummy body (#10704)
  • [pylint] Implement invalid-bytes-returned (E0308) (#10959)
  • [pylint] Implement invalid-length-returned (E0303) (#10963)
  • [pylint] Implement self-cls-assignment (W0642) (#9267)
  • [pylint] Omit stubs from invalid-bool and invalid-str-return-type (#11008)
  • [ruff] New rule unused-async (RUF029) to detect unneeded async keywords on functions (#9966)

Rule changes

  • [flake8-bandit] Allow urllib.request.urlopen calls with static Request argument (S310) (#10964)
  • [flake8-bugbear] Treat raise NotImplemented-only bodies as stub functions (B006) (#10990)
  • [flake8-slots] Respect same-file Enum subclasses (SLOT000) (#11006)
  • [pylint] Support inverted comparisons (PLR1730) (#10920)

Linter

  • Improve handling of builtin symbols in linter rules (#10919)
  • Improve display of rules in --show-settings (#11003)
  • Improve inference capabilities of the BuiltinTypeChecker (#10976)
  • Resolve classes and functions relative to script name (#10965)
  • Improve performance of RuleTable::any_enabled (#10971)

Server

This section is devoted to updates for our new language server, written in Rust.

  • Enable ruff-specific source actions (#10916)
  • Refreshes diagnostics for open files when file configuration is changed (#10988)
  • Important errors are now shown as popups (#10951)
  • Introduce settings for directly configuring the linter and formatter (#10984)
  • Resolve configuration for each document individually (#10950)
  • Write a setup guide for Neovim (#10987)

Configuration

  • Add RUFF_OUTPUT_FILE environment variable support (#10992)

Bug fixes

  • Avoid non-augmented-assignment for reversed, non-commutative operators (PLR6104) (#10909)
  • Limit commutative non-augmented-assignments to primitive data types (PLR6104) (#10912)
  • Respect per-file-ignores for RUF100 on blanket # noqa (#10908)
  • Consider if expression for parenthesized with items parsing (#11010)
  • Consider binary expr for parenthesized with items parsing (#11012)
  • Reset FOR_TARGET context for all kinds of parentheses (#11009)

0.3.7

Preview features

  • [flake8-bugbear] Implement loop-iterator-mutation (B909) (#9578)
  • [pylint] Implement rule to prefer augmented assignment (PLR6104) (#9932)

Bug fixes

  • Avoid TOCTOU errors in cache initialization (#10884)
  • [pylint] Recode nan-comparison rule to W0177 (#10894)
  • [pylint] Reverse min-max logic in if-stmt-min-max (#10890)

0.3.6

Preview features

  • [pylint] Implement bad-staticmethod-argument (PLW0211) (#10781)
  • [pylint] Implement if-stmt-min-max (PLR1730, PLR1731) (#10002)
  • [pyupgrade] Replace str,Enum multiple inheritance with StrEnum UP042 (#10713)
  • [refurb] Implement if-expr-instead-of-or-operator (FURB110) (#10687)
  • [refurb] Implement int-on-sliced-str (FURB166) (#10650)
  • [refurb] Implement write-whole-file (FURB103) (#10802)
  • [refurb] Support itemgetter in reimplemented-operator (FURB118) (#10526)
  • [flake8_comprehensions] Add sum/min/max to unnecessary comprehension check (C419) (#10759)

Rule changes

  • [pydocstyle] Require capitalizing docstrings where the first sentence is a single word (D403) (#10776)
  • [pycodestyle] Ignore annotated lambdas in class scopes (E731) (#10720)
  • [flake8-pyi] Various improvements to PYI034 (#10807)
  • [flake8-slots] Flag subclasses of call-based typing.NamedTuples as well as subclasses of collections.namedtuple() (SLOT002) (#10808)
  • [pyflakes] Allow forward references in class bases in stub files (F821) (#10779)
  • [pygrep-hooks] Improve blanket-noqa error message (PGH004) (#10851)

CLI

  • Support FORCE_COLOR env var (#10839)

Configuration

  • Support negated patterns in [extend-]per-file-ignores (#10852)

Bug fixes

  • [flake8-import-conventions] Accept non-aliased (but correct) import in unconventional-import-alias (ICN001) (#10729)
  • [flake8-quotes] Add semantic model flag when inside f-string replacement field (#10766)
  • [pep8-naming] Recursively resolve TypeDicts for N815 violations (#10719)
  • [flake8-quotes] Respect Q00* ignores in flake8-quotes rules (#10728)
  • [flake8-simplify] Show negated condition in needless-bool diagnostics (SIM103) (#10854)
  • [ruff] Use within-scope shadowed bindings in asyncio-dangling-task (RUF006) (#10793)
  • [flake8-pytest-style] Fix single-tuple conversion in pytest-parametrize-values-wrong-type (PT007) (#10862)
  • [flake8-return] Ignore assignments to annotated variables in unnecessary-assign (RET504) (#10741)
  • [refurb] Do not allow any keyword arguments for read-whole-file in rb mode (FURB101) (#10803)
  • [pylint] Don't recommend decorating staticmethods with @singledispatch (PLE1519, PLE1520) (#10637)
  • [pydocstyle] Use section name range for all section-related docstring diagnostics (#10740)
  • Respect # noqa directives on __all__ openers (#10798)

0.3.5

Preview features

  • [pylint] Implement modified-iterating-set (E4703) (#10473)
  • [refurb] Implement for-loop-set-mutations (FURB142) (#10583)
  • [refurb] Implement unnecessary-from-float (FURB164) (#10647)
  • [refurb] Implement verbose-decimal-constructor (FURB157) (#10533)

Rule changes

  • [flake8-comprehensions] Handled special case for C401 which also matches C416 (#10596)
  • [flake8-pyi] Mark unaliased-collections-abc-set-import fix as "safe" for more cases in stub files (PYI025) (#10547)
  • [numpy] Add row_stack to NumPy 2.0 migration rule (#10646)
  • [pycodestyle] Allow cell magics before an import (E402) (#10545)
  • [pycodestyle] Avoid blank line rules for the first logical line in cell (#10291)

Configuration

  • Respected nested namespace packages (#10541)
  • [flake8-boolean-trap] Add setting for user defined allowed boolean trap (#10531)

Bug fixes

  • Correctly handle references in __all__ definitions when renaming symbols in autofixes (#10527)
  • Track ranges of names inside __all__ definitions (#10525)
  • [flake8-bugbear] Avoid false positive for usage after continue (B031) (#10539)
  • [flake8-copyright] Accept commas in default copyright pattern (#9498)
  • [flake8-datetimez] Allow f-strings with %z for DTZ007 (#10651)
  • [flake8-pytest-style] Fix PT014 autofix for last item in list (#10532)
  • [flake8-quotes] Ignore Q000, Q001 when string is inside forward ref (#10585)
  • [isort] Always place non-relative imports after relative imports (#10669)
  • [isort] Respect Unicode characters in import sorting (#10529)
  • [pyflakes] Fix F821 false negatives when from __future__ import annotations is active (attempt 2) (#10524)
  • [pyflakes] Make unnecessary-lambda an always-unsafe fix (#10668)
  • [pylint] Fixed false-positive on the rule PLW1641 (eq-without-hash) (#10566)
  • [ruff] Fix panic in unused # noqa removal with multi-byte space (RUF100) (#10682)

Documentation

  • Add PR title format to CONTRIBUTING.md (#10665)
  • Fix list markup to include blank lines required (#10591)
  • Put flake8-logging next to the other flake8 plugins in registry (#10587)
  • [flake8-bandit] Update warning message for rule S305 to address insecure block cipher mode use (#10602)
  • [flake8-bugbear] Document use of anonymous assignment in useless-expression (#10551)
  • [flake8-datetimez] Clarify error messages and docs for DTZ rules (#10621)
  • [pycodestyle] Use same before vs. after numbers for space-around-operator (#10640)
  • [ruff] Change quadratic-list-summation docs to use iadd consistently (#10666)

0.3.4

Preview features

  • [flake8-simplify] Detect implicit else cases in needless-bool (SIM103) (#10414)
  • [pylint] Implement nan-comparison (PLW0117) (#10401)
  • [pylint] Implement nonlocal-and-global (E115) (#10407)
  • [pylint] Implement singledispatchmethod-function (PLE5120) (#10428)
  • [refurb] Implement list-reverse-copy (FURB187) (#10212)

Rule changes

  • [flake8-pytest-style] Add automatic fix for pytest-parametrize-values-wrong-type (PT007) (#10461)
  • [pycodestyle] Allow SPDX license headers to exceed the line length (E501) (#10481)

Formatter

  • Fix unstable formatting for trailing subscript end-of-line comment (#10492)

Bug fixes

  • Avoid code comment detection in PEP 723 script tags (#10464)
  • Avoid incorrect tuple transformation in single-element case (C409) (#10491)
  • Bug fix: Prevent fully defined links name from being reformatted (#10442)
  • Consider raw source code for W605 (#10480)
  • Docs: Link inline settings when not part of options section (#10499)
  • Don't treat annotations as redefinitions in .pyi files (#10512)
  • Fix E231 bug: Inconsistent catch compared to pycodestyle, such as when dict nested in list (#10469)
  • Fix pylint upstream categories not showing in docs (#10441)
  • Add missing Options references to blank line docs (#10498)
  • 'Revert "F821: Fix false negatives in .py files when from __future__ import annotations is active (#10362)"' (#10513)
  • Apply NFKC normalization to unicode identifiers in the lexer (#10412)
  • Avoid failures due to non-deterministic binding ordering (#10478)
  • [flake8-bugbear] Allow tuples of exceptions (B030) (#10437)
  • [flake8-quotes] Avoid syntax errors due to invalid quotes (Q000, Q002) (#10199)

0.3.3

Preview features

  • [flake8-bandit]: Implement S610 rule (#10316)
  • [pycodestyle] Implement blank-line-at-end-of-file (W391) (#10243)
  • [pycodestyle] Implement redundant-backslash (E502) (#10292)
  • [pylint] - implement redeclared-assigned-name (W0128) (#9268)

Rule changes

  • [flake8_comprehensions] Handled special case for C400 which also matches C416 (#10419)
  • [flake8-bandit] Implement upstream updates for S311, S324 and S605 (#10313)
  • [pyflakes] Remove F401 fix for __init__ imports by default and allow opt-in to unsafe fix (#10365)
  • [pylint] Implement invalid-bool-return-type (E304) (#10377)
  • [pylint] Include builtin warnings in useless-exception-statement (PLW0133) (#10394)

CLI

  • Add message on success to ruff check (#8631)

Bug fixes

  • [PIE970] Allow trailing ellipsis in typing.TYPE_CHECKING (#10413)
  • Avoid TRIO115 if the argument is a variable (#10376)
  • [F811] Avoid removing shadowed imports that point to different symbols (#10387)
  • Fix F821 and F822 false positives in .pyi files (#10341)
  • Fix F821 false negatives in .py files when from __future__ import annotations is active (#10362)
  • Fix case where Indexer fails to identify continuation preceded by newline #10351 (#10354)
  • Sort hash maps in Settings display (#10370)
  • Track conditional deletions in the semantic model (#10415)
  • [C413] Wrap expressions in parentheses when negating (#10346)
  • [pycodestyle] Do not ignore lines before the first logical line in blank lines rules. (#10382)
  • [pycodestyle] Do not trigger E225 and E275 when the next token is a ')' (#10315)
  • [pylint] Avoid false-positive slot non-assignment for __dict__ (PLE0237) (#10348)
  • Gate f-string struct size test for Rustc < 1.76 (#10371)

Documentation

  • Use ruff.toml format in README (#10393)
  • [RUF008] Make it clearer that a mutable default in a dataclass is only valid if it is typed as a ClassVar (#10395)
  • [pylint] Extend docs and test in invalid-str-return-type (E307) (#10400)
  • Remove . from check and format commands (#10217)

0.3.2

Preview features

  • Improve single-with item formatting for Python 3.8 or older (#10276)

Rule changes

  • [pyupgrade] Allow fixes for f-string rule regardless of line length (UP032) (#10263)
  • [pycodestyle] Include actual conditions in E712 diagnostics (#10254)

Bug fixes

  • Fix trailing kwargs end of line comment after slash (#10297)
  • Fix unstable with items formatting (#10274)
  • Avoid repeating function calls in f-string conversions (#10265)
  • Fix E203 false positive for slices in format strings (#10280)
  • Fix incorrect Parameter range for *args and **kwargs (#10283)
  • Treat typing.Annotated subscripts as type definitions (#10285)

0.3.1

Preview features

  • [pycodestyle] Fix E301 not triggering on decorated methods. (#10117)
  • [pycodestyle] Respect isort settings in blank line rules (E3*) (#10096)
  • [pycodestyle] Make blank lines in typing stub files optional (E3*) (#10098)
  • [pylint] Implement singledispatch-method (E1519) (#10140)
  • [pylint] Implement useless-exception-statement (W0133) (#10176)

Rule changes

  • [flake8-debugger] Check for use of debugpy and ptvsd debug modules (#10177) (#10194)
  • [pyupgrade] Generate diagnostic for all valid f-string conversions regardless of line length (UP032) (#10238)
  • [pep8_naming] Add fixes for N804 and N805 (#10215)

CLI

  • Colorize the output of ruff format --diff (#10110)
  • Make --config and --isolated global flags (#10150)
  • Correctly expand tildes and environment variables in paths passed to --config (#10219)

Configuration

  • Accept a PEP 440 version specifier for required-version (#10216)
  • Implement isort's default-section setting (#10149)

Bug fixes

  • Remove trailing space from CapWords message (#10220)
  • Respect external codes in file-level exemptions (#10203)
  • [flake8-raise] Avoid false-positives for parens-on-raise with future.exception() (RSE102) (#10206)
  • [pylint] Add fix for unary expressions in PLC2801 (#9587)
  • [ruff] Fix RUF028 not allowing # fmt: skip on match cases (#10178)

0.3.0

This release introduces the new Ruff formatter 2024.2 style and adds a new lint rule to detect invalid formatter suppression comments.

Preview features

  • [flake8-bandit] Remove suspicious-lxml-import (S410) (#10154)
  • [pycodestyle] Allow os.environ modifications between imports (E402) (#10066)
  • [pycodestyle] Don't warn about a single whitespace character before a comma in a tuple (E203) (#10094)

Rule changes

  • [eradicate] Detect commented out case statements (ERA001) (#10055)
  • [eradicate] Detect single-line code for try:, except:, etc. (ERA001) (#10057)
  • [flake8-boolean-trap] Allow boolean positionals in __post_init__ (#10027)
  • [flake8-copyright] Allow © in copyright notices (#10065)
  • [isort]: Use one blank line after imports in typing stub files (#9971)
  • [pylint] New Rule dict-iter-missing-items (PLE1141) (#9845)
  • [pylint] Ignore sys.version and sys.platform (PLR1714) (#10054)
  • [pyupgrade] Detect literals with unary operators (UP018) (#10060)
  • [ruff] Expand rule for list(iterable).pop(0) idiom (RUF015) (#10148)

Formatter

This release introduces the Ruff 2024.2 style, stabilizing the following changes:

  • Prefer splitting the assignment's value over the target or type annotation (#8943)
  • Remove blank lines before class docstrings (#9154)
  • Wrap multiple context managers in with parentheses when targeting Python 3.9 or newer (#9222)
  • Add a blank line after nested classes with a dummy body (...) in typing stub files (#9155)
  • Reduce vertical spacing for classes and functions with a dummy (...) body (#7440, #9240)
  • Add a blank line after the module docstring (#8283)
  • Parenthesize long type hints in assignments (#9210)
  • Preserve indent for single multiline-string call-expressions (#9673)
  • Normalize hex escape and unicode escape sequences (#9280)
  • Format module docstrings (#9725)

CLI

  • Explicitly disallow extend as part of a --config flag (#10135)
  • Remove build from the default exclusion list (#10093)
  • Deprecate ruff <path>, ruff --explain, ruff --clean, and ruff --generate-shell-completion in favor of ruff check <path>, ruff rule, ruff clean, and ruff generate-shell-completion (#10169)
  • Remove the deprecated CLI option --format from ruff rule and ruff linter (#10170)

Bug fixes

  • [flake8-bugbear] Avoid adding default initializers to stubs (B006) (#10152)
  • [flake8-type-checking] Respect runtime-required decorators for function signatures (#10091)
  • [pycodestyle] Mark fixes overlapping with a multiline string as unsafe (W293) (#10049)
  • [pydocstyle] Trim whitespace when removing blank lines after section (D413) (#10162)
  • [pylint] Delete entire statement, including semicolons (PLR0203) (#10074)
  • [ruff] Avoid f-string false positives in gettext calls (RUF027) (#10118)
  • Fix ruff crashing on PowerPC systems because of too small page size (#10080)

Performance

  • Add cold attribute to less likely printer queue branches in the formatter (#10121)
  • Skip unnecessary string normalization in the formatter (#10116)

Documentation

  • Remove "Beta" Label from formatter documentation (#10144)
  • line-length option: fix link to pycodestyle.max-line-length (#10136)

0.2.2

Highlights include:

  • Initial support formatting f-strings (in --preview).
  • Support for overriding arbitrary configuration options via the CLI through an expanded --config argument (e.g., --config "lint.isort.combine-as-imports=false").
  • Significant performance improvements in Ruff's lexer, parser, and lint rules.

Preview features

  • Implement minimal f-string formatting (#9642)
  • [pycodestyle] Add blank line(s) rules (E301, E302, E303, E304, E305, E306) (#9266)
  • [refurb] Implement readlines_in_for (FURB129) (#9880)

Rule changes

  • [ruff] Ensure closing parentheses for multiline sequences are always on their own line (RUF022, RUF023) (#9793)
  • [numpy] Add missing deprecation violations (NPY002) (#9862)
  • [flake8-bandit] Detect mark_safe usages in decorators (#9887)
  • [ruff] Expand asyncio-dangling-task (RUF006) to include new_event_loop (#9976)
  • [flake8-pyi] Ignore 'unused' private type dicts in class scopes (#9952)

Formatter

  • Docstring formatting: Preserve tab indentation when using indent-style=tabs (#9915)
  • Disable top-level docstring formatting for notebooks (#9957)
  • Stabilize quote-style's preserve mode (#9922)

CLI

  • Allow arbitrary configuration options to be overridden via the CLI (#9599)

Bug fixes

  • Make show-settings filters directory-agnostic (#9866)
  • Respect duplicates when rewriting type aliases (#9905)
  • Respect tuple assignments in typing analyzer (#9969)
  • Use atomic write when persisting cache (#9981)
  • Use non-parenthesized range for DebugText (#9953)
  • [flake8-simplify] Avoid false positive with async for loops (SIM113) (#9996)
  • [flake8-trio] Respect async with in timeout-without-await (#9859)
  • [perflint] Catch a wider range of mutations in PERF101 (#9955)
  • [pycodestyle] Fix E30X panics on blank lines with trailing white spaces (#9907)
  • [pydocstyle] Allow using parameters as a subsection header (D405) (#9894)
  • [pydocstyle] Fix blank-line docstring rules for module-level docstrings (#9878)
  • [pylint] Accept 0.0 and 1.0 as common magic values (PLR2004) (#9964)
  • [pylint] Avoid suggesting set rewrites for non-hashable types (#9956)
  • [ruff] Avoid false negatives with string literals inside of method calls (RUF027) (#9865)
  • [ruff] Fix panic on with f-string detection (RUF027) (#9990)
  • [ruff] Ignore builtins when detecting missing f-strings (#9849)

Performance

  • Use memchr for string lexing (#9888)
  • Use memchr for tab-indentation detection (#9853)
  • Reduce Result<Tok, LexicalError> size by using Box<str> instead of String (#9885)
  • Reduce size of Expr from 80 to 64 bytes (#9900)
  • Improve trailing comma rule performance (#9867)
  • Remove unnecessary string cloning from the parser (#9884)

0.2.1

This release includes support for range formatting (i.e., the ability to format specific lines within a source file).

Preview features

  • [refurb] Implement missing-f-string-syntax (RUF027) (#9728)
  • Format module-level docstrings (#9725)

Formatter

  • Add --range option to ruff format (#9733)
  • Don't trim last empty line in docstrings (#9813)

Bug fixes

  • Skip empty lines when determining base indentation (#9795)
  • Drop __get__ and __set__ from unnecessary-dunder-call (#9791)
  • Respect generic Protocol in ellipsis removal (#9841)
  • Revert "Use publicly available Apple Silicon runners (#9726)" (#9834)

Performance

  • Skip LibCST parsing for standard dedent adjustments (#9769)
  • Remove CST-based fixer for C408 (#9822)
  • Add our own ignored-names abstractions (#9802)
  • Remove CST-based fixers for C400, C401, C410, and C418 (#9819)
  • Use AhoCorasick to speed up quote match (#9773)
  • Remove CST-based fixers for C405 and C409 (#9821)
  • Add fast-path for comment detection (#9808)
  • Invert order of checks in zero-sleep-call (#9766)
  • Short-circuit typing matches based on imports (#9800)
  • Run dunder method rule on methods directly (#9815)
  • Track top-level module imports in the semantic model (#9775)
  • Slight speed-up for lowercase and uppercase identifier checks (#9798)
  • Remove LibCST-based fixer for C403 (#9818)

Documentation

  • Update max-pos-args example to max-positional-args (#9797)
  • Fixed example code in weak_cryptographic_key.rs (#9774)
  • Fix references to deprecated ANN rules in changelog (#9771)
  • Fix default for max-positional-args (#9838)

0.2.0

Breaking changes

  • The NURSERY selector cannot be used anymore
  • Legacy selection of nursery rules by exact codes is no longer allowed without preview enabled

See also, the "Remapped rules" section which may result in disabled rules.

Deprecations

The following rules are now deprecated:

The following command line options are now deprecated:

  • --show-source; use --output-format full instead
  • --no-show-source; use --output-format concise instead
  • --output-format text; use full or concise instead

The following settings have moved and the previous name is deprecated:

Remapped rules

The following rules have been remapped to new codes:

Stabilizations

The following rules have been stabilized and are no longer in preview:

Fixes for the following rules have been stabilized and are now available without preview:

Fixes for the following rules have been promoted from unsafe to safe:

The following behaviors have been stabilized:

Preview features

  • [refurb] Implement metaclass_abcmeta (FURB180) (#9658)
  • Implement blank_line_after_nested_stub_class preview style (#9155)
  • The preview rule and-or-ternary (PLR1706) was removed

Bug fixes

  • [flake8-async] Take pathlib.Path into account when analyzing async functions (#9703)
  • [flake8-return] - fix indentation syntax error (RET505) (#9705)
  • Detect multi-statement lines in else removal (#9748)
  • RUF022, RUF023: never add two trailing commas to the end of a sequence (#9698)
  • RUF023: Don't sort __match_args__, only __slots__ (#9724)
  • [flake8-simplify] - Fix syntax error in autofix (SIM114) (#9704)
  • [pylint] Show verbatim constant in magic-value-comparison (PLR2004) (#9694)
  • Removing trailing whitespace inside multiline strings is unsafe (#9744)
  • Support IfExp with dual string arms in invalid-envvar-default (#9734)
  • [pylint] Add __mro_entries__ to known dunder methods (PLW3201) (#9706)

Documentation

  • Removed rules are now retained in the documentation (#9691)
  • Deprecated rules are now indicated in the documentation (#9689)

0.1.15

Preview features

  • Error when NURSERY selector is used with --preview (#9682)
  • Preserve indentation around multiline strings in formatter (#9637)
  • [flake8-return] Add fixes for all rules (RET505, RET506, RET507, RET508) (#9595)
  • [flake8-simplify] Add fix for if-with-same-arms (SIM114) (#9591)
  • [pycodestyle] Add fix for multiple-imports-on-one-line (E401) (#9518)
  • [pylint] Add fix for collapsible-else-if (PLR5501) (#9594)
  • [pylint] Add fix for useless-else-on-loop (PLW0120) (#9590)
  • [pylint] Implement assigning-non-slot (E0237) (#9623)
  • [pylint] Implement potential-index-error (PLE0643) (#9545)
  • [pylint] Implement too-many-nested-blocks (PLR1702) (#9172)
  • [ruff] Add rule to sort __slots__ and __match_args__ (#9564)
  • [ruff] Detect unnecessary dict comprehensions for iterables (RUF025) (#9613)
  • [ruff] Guard against use of default_factory as a keyword argument (RUF026) (#9651)
  • [ruff] Implement mutable-fromkeys-value (RUF024) (#9597)

CLI

  • Enable auto-wrapping of --help output (#9633)

Bug fixes

  • Avoid rendering display-only rules as fixable (#9649)
  • Detect automagic-like assignments in notebooks (#9653)
  • Generate custom JSON schema for dynamic setting (#9632)
  • [flake8-no-pep420] Include global --config when determining namespace packages (#9603)
  • [flake8-pie] Omit bound tuples passed to .startswith or .endswith (#9661)
  • [flake8-return] Avoid panic when fixing inlined else blocks (#9657)
  • [flake8-return] Consider exception suppression in unnecessary assignment (#9673)
  • [flake8-return] Take NoReturn annotation into account when analyzing implicit returns (#9636)
  • [flake8-simplify] Support inverted returns in needless-bool (SIM103) (#9619)
  • [flake8-type-checking] Add Pydantic's BaseConfig to default-copy list (#9650)
  • [flake8-type-checking] Avoid marking InitVar as a typing-only annotation (#9688)
  • [pycodestyle] Allow dtype comparisons in type-comparison (#9676)
  • [pydocstyle] Re-implement last-line-after-section (D413) (#9654)

Documentation

  • [flake8-pytest-style] Add fix safety documentation for duplicate-parameterize-test-cases (#9678)
  • [pylint] Document literal-membership fix safety conditions (#9677)
  • [isort] Fix reference to isort rule code (#9598)

0.1.14

Preview features

  • [flake8-bugbear] Add fix for duplicate-value (B033) (#9510)
  • [flake8-simplify] Implement enumerate-for-loop (SIM113) (#7777)
  • [pygrep_hooks] Add fix for deprecated-log-warn (PGH002) (#9519)
  • [pylint] Implement import-private-name (C2701) (#5920)
  • [refurb] Implement regex-flag-alias with fix (FURB167) (#9516)
  • [ruff] Add rule and fix to sort contents of __all__ (RUF022) (#9474)
  • [tryceratops] Add fix for error-instead-of-exception (TRY400) (#9520)

Rule changes

  • [flake8-pyi] Fix PYI047 false negatives on PEP-695 type aliases (#9566)
  • [flake8-pyi] Fix PYI049 false negatives on call-based TypedDicts (#9567)
  • [pylint] Exclude self and cls when counting method arguments (PLR0917) (#9563)

CLI

  • --show-settings displays active settings in a far more readable format (#9464)
  • Add --extension support to the formatter (#9483)

Configuration

  • Ignore preview status for fixable and unfixable selectors (#9538)
  • [pycodestyle] Use the configured tab size when expanding indents (#9506)

Bug fixes

  • Recursively visit deferred AST nodes (#9541)
  • Visit deferred lambdas before type definitions (#9540)
  • [flake8-simplify] Avoid some more enumerate-for-loop false positives (SIM113) (#9515)
  • [pandas-vet] Limit inplace diagnostics to methods that accept inplace (#9495)
  • [pylint] Add the __prepare__ method to the list of recognized dunder method (#9529)
  • [pylint] Ignore unnecessary dunder calls within dunder definitions (#9496)
  • [refurb] Avoid bailing when reimplemented-operator is called on function (FURB118) (#9556)
  • [ruff] Avoid treating named expressions as static keys (RUF011) (#9494)

Documentation

  • Add instructions on using noqa with isort rules (#9555)
  • Documentation update for URL giving 'page not found' (#9565)
  • Fix admonition in dark mode (#9502)
  • Update contributing docs to use cargo bench -p ruff_benchmark (#9535)
  • Update emacs integration section to include emacs-ruff-format (#9403)
  • [flake8-blind-except] Document exceptions to blind-except rule (#9580)

0.1.13

Bug fixes

  • Include base pyproject when initializing cache settings (#9480)
  • [flake8-simplify] Account for possibly-empty f-string values in truthiness logic (#9484)
  • [pylint] Add the missing period in unnecessary-dunder-call (#9485)
  • [pylint] Fix __aenter__ message in unnecessary-dunder-call (#9492)

0.1.12

Preview features

  • Formatter: Hug multiline-strings in preview style (#9243)
  • [flake8-bandit] Add ssl-with-no-version (S504) (#9384)
  • [flake8-bandit] Implement ssl-insecure-version (S502) (#9390)
  • [flake8-bandit] Implement ssl-with-bad-defaults (S503) (#9391)
  • [flake8-bandit] Implement suspicious import rules (S4XX) (#8831)
  • [flake8-simplify] Implement zip-dict-keys-and-values (SIM911) (#9460)
  • [pyflakes] Add a fix for redefined-while-unused (F811) (#9419)
  • [pylint] Implement unnecessary-dunder-call (C2801) (#9166)
  • [ruff] Add parenthesize-chained-operators (RUF021) to enforce parentheses in a or b and c (#9440)

Rule changes

  • [flake8-boolean-trap] Allow Boolean positional arguments in setters (#9429)
  • [flake8-builtins] Restrict builtin-attribute-shadowing (A003) to actual shadowed references (#9462)
  • [flake8-pyi] Add fix for generator-return-from-iter-method (PYI058) (#9355)
  • [pyflakes] Don't flag redefined-while-unused (F811) in if branches (#9418)
  • [pyupgrade] Add some additional Python 3.12 typing members to deprecated-import (#9445)
  • [ruff] Add fix for parenthesize-chained-operators (RUF021) (#9449)
  • [ruff] Include subscripts and attributes in static key rule (RUF011) (#9416)
  • [ruff] Support variable keys in static dictionary key rule (RUF011) (#9411)

Formatter

  • Generate deterministic IDs when formatting notebooks (#9359)
  • Allow # fmt: skip with interspersed same-line comments (#9395)
  • Parenthesize breaking named expressions in match guards (#9396)

Bug fixes

  • Add cell indexes to all diagnostics (#9387)
  • Avoid infinite loop in constant vs. None comparisons (#9376)
  • Handle raises with implicit alternate branches (#9377)
  • Ignore trailing quotes for unclosed l-brace errors (#9388)
  • Respect multi-segment submodule imports when resolving qualified names (#9382)
  • Use DisplayParseError for stdin parser errors (#9409)
  • Use comment_ranges for isort directive extraction (#9414)
  • Use transformed source code for diagnostic locations (#9408)
  • [flake8-pyi] Exclude warnings.deprecated and typing_extensions.deprecated arguments (#9423)
  • [flake8-pyi] Fix false negative for unused-private-protocol (PYI046) with unused generic protocols (#9405)
  • [pydocstyle] Disambiguate argument descriptors from section headers (#9427)
  • [pylint] Homogenize PLR0914 message to match other PLR09XX rules (#9399)
  • [ruff] Allow Hashable = None in type annotations (RUF013) (#9442)

Documentation

  • Fix admonition hyperlink colouring (#9385)
  • Add missing preview link (#9386)

0.1.11

Preview features

  • [pylint] Implement super-without-brackets (W0245) (#9257)

Bug fixes

  • Check path string properly in python -m ruff invocations (#9367)

Documentation

  • Tweak relative-imports message (#9365)
  • Add fix safety note for yield-in-for-loop (#9364)

0.1.10

Preview features

  • Improve dummy_implementations preview style formatting (#9240)
  • Normalise Hex and unicode escape sequences in strings (#9280)
  • Parenthesize long type annotations in annotated assignments (#9210)
  • Parenthesize multi-context managers in with statements (#9222)
  • [flake8-pyi] Implement generator-return-from-iter-method (PYI058) (#9313)
  • [pylint] Implement empty-comment (PLR2044) (#9174)
  • [refurb] Implement bit-count (FURB161) (#9265)
  • [ruff] Add never-union rule to detect redundant typing.NoReturn and typing.Never (#9217)

CLI

  • Add paths to TOML parse errors (#9358)
  • Add row and column numbers to formatter parse errors (#9321)
  • Improve responsiveness when invoked via Python (#9315)
  • Short rule messages should not end with a period (#9345)

Configuration

  • Respect runtime-required decorators on functions (#9317)

Bug fixes

  • Avoid asyncio-dangling-task for nonlocal and global bindings (#9263)
  • Escape trailing placeholders in rule documentation (#9301)
  • Fix continuation detection following multi-line strings (#9332)
  • Fix scoping for generators in named expressions in classes (#9248)
  • Port from obsolete wsl crate to is-wsl (#9356)
  • Remove special pre-visit for module docstrings (#9261)
  • Respect __str__ definitions from super classes (#9338)
  • Respect unused-noqa via per-file-ignores (#9300)
  • Respect attribute chains when resolving builtin call paths (#9309)
  • Treat all typing_extensions members as typing aliases (#9335)
  • Use Display for formatter parse errors (#9316)
  • Wrap subscripted dicts in parens for f-string conversion (#9238)
  • [flake8-annotations] Avoid adding return types to stub methods (#9277)
  • [flake8-annotations] Respect mixed return and raise cases in return-type analysis (#9310)
  • [flake8-bandit] Don't report violations when SafeLoader is imported from yaml.loader (S506) (#9299)
  • [pylint] Avoid panic when comment is preceded by Unicode (#9331)
  • [pylint] Change PLR0917 error message to match other PLR09XX messages (#9308)
  • [refurb] Avoid false positives for math-constant (FURB152) (#9290)

Documentation

  • Expand target name for better rule documentation (#9302)
  • Fix typos found by codespell (#9346)
  • [perflint] Document PERF102 fix un-safety (#9351)
  • [pyupgrade] Document UP007 fix un-safety (#9306)

0.1.9

Breaking changes

  • Add site-packages to default exclusions (#9188)

Preview features

  • Fix: Avoid parenthesizing subscript targets and values (#9209)
  • [pylint] Implement too-many-locals (PLR0914) (#9163)
  • Implement reimplemented_operator (FURB118) (#9171)
  • Add a rule to detect string members in runtime-evaluated unions (#9143)
  • Implement no_blank_line_before_class_docstring preview style (#9154)

Rule changes

  • CONSTANT_CASE variables are improperly flagged for yoda violation (SIM300) (#9164)
  • [flake8-pyi] Cover ParamSpecs and TypeVarTuples (PYI018) (#9198)
  • [flake8-bugbear] Add fix for zip-without-explicit-strict (B905) (#9176)
  • Add fix to automatically remove print and pprint statements (T201, T203) (#9208)
  • Prefer Never to NoReturn in auto-typing in Python >= 3.11 (ANN201) (#9213)

Formatter

  • can_omit_optional_parentheses: Exit early for unparenthesized expressions (#9125)
  • Fix dynamic mode with doctests so that it doesn't exceed configured line width (#9129)
  • Fix can_omit_optional_parentheses for expressions with a right most fstring (#9124)
  • Add target_version to formatter options (#9220)

CLI

  • Update ruff format --check to display message for already formatted files (#9153)

Bug fixes

  • Reverse order of arguments for operator.contains (#9192)
  • Iterate over lambdas in deferred type annotations (#9175)
  • Fix panic in D208 with multibyte indent (#9147)
  • Add support for NoReturn in auto-return-typing (#9206)
  • Allow removal of typing from exempt-modules (#9214)
  • Avoid mutable-class-default violations for Pydantic subclasses (#9187)
  • Fix dropped union expressions for piped non-types in PYI055 autofix (#9161)
  • Enable annotation quoting for multi-line expressions (#9142)
  • Deduplicate edits when quoting annotations (#9140)
  • Prevent invalid utf8 indexing in cell magic detection (#9146)
  • Avoid nested quotations in auto-quoting fix (#9168)
  • Add base-class inheritance detection to flake8-django rules (#9151)
  • Avoid asyncio-dangling-task violations on shadowed bindings (#9215)

Documentation

  • Fix blog post URL in changelog (#9119)
  • Add error suppression hint for multi-line strings (#9205)
  • Fix typo in SemanticModel.parent_expression docstring (#9167)
  • Document link between import sorting and formatter (#9117)

0.1.8

This release includes opt-in support for formatting Python snippets within docstrings via the docstring-code-format setting. Check out the blog post for more details!

Preview features

  • Add "preserve" quote-style to mimic Black's skip-string-normalization (#8822)
  • Implement prefer_splitting_right_hand_side_of_assignments preview style (#8943)
  • [pycodestyle] Add fix for unexpected-spaces-around-keyword-parameter-equals (#9072)
  • [pycodestyle] Add fix for comment-related whitespace rules (#9075)
  • [pycodestyle] Allow sys.path modifications between imports (#9047)
  • [refurb] Implement hashlib-digest-hex (FURB181) (#9077)

Rule changes

  • Allow flake8-type-checking rules to automatically quote runtime-evaluated references (#6001)
  • Allow transparent cell magics in Jupyter Notebooks (#8911)
  • [flake8-annotations] Avoid ANN2xx fixes for abstract methods with empty bodies (#9034)
  • [flake8-self] Ignore underscore references in type annotations (#9036)
  • [pep8-naming] Allow class names when apps.get_model is a non-string (#9065)
  • [pycodestyle] Allow matplotlib.use calls to intersperse imports (#9094)
  • [pyflakes] Support fixing unused assignments in tuples by renaming variables (F841) (#9107)
  • [pylint] Add fix for subprocess-run-without-check (PLW1510) (#6708)

Formatter

  • Add docstring-code-format knob to enable docstring snippet formatting (#8854)
  • Use double quotes for all docstrings, including single-quoted docstrings (#9020)
  • Implement "dynamic" line width mode for docstring code formatting (#9098)
  • Support reformatting Markdown code blocks (#9030)
  • add support for formatting reStructuredText code snippets (#9003)
  • Avoid trailing comma for single-argument with positional separator (#9076)
  • Fix handling of trailing target comment (#9051)

CLI

  • Hide unsafe fix suggestions when explicitly disabled (#9095)
  • Add SARIF support to --output-format (#9078)

Bug fixes

  • Apply unnecessary index rule prior to enumerate rewrite (#9012)
  • [flake8-err-msg] Allow EM fixes even if msg variable is defined (#9059)
  • [flake8-pie] Prevent keyword arguments duplication (#8450)
  • [flake8-pie] Respect trailing comma in unnecessary-dict-kwargs (PIE804) (#9015)
  • [flake8-raise] Avoid removing parentheses on ctypes.WinError (#9027)
  • [isort] Avoid invalid combination of force-sort-within-types and lines-between-types (#9041)
  • [isort] Ensure that from-style imports are always ordered first in __future__ (#9039)
  • [pycodestyle] Allow tab indentation before keyword (#9099)
  • [pylint] Ignore @overrides and @overloads for too-many-positional (#9000)
  • [pyupgrade] Enable printf-string-formatting fix with comments on right-hand side (#9037)
  • [refurb] Make math-constant (FURB152) rule more targeted (#9054)
  • [refurb] Support floating-point base in redundant-log-base (FURB163) (#9100)
  • [ruff] Detect unused-asyncio-dangling-task (RUF006) on unused assignments (#9060)

0.1.7

Preview features

  • Implement multiline dictionary and list hugging for preview style (#8293)
  • Implement the fix_power_op_line_length preview style (#8947)
  • Use Python version to determine typing rewrite safety (#8919)
  • [flake8-annotations] Enable auto-return-type involving Optional and Union annotations (#8885)
  • [flake8-bandit] Implement django-raw-sql (S611) (#8651)
  • [flake8-bandit] Implement tarfile-unsafe-members (S202) (#8829)
  • [flake8-pyi] Implement fix for unnecessary-literal-union (PYI030) (#7934)
  • [flake8-simplify] Extend dict-get-with-none-default (SIM910) to non-literals (#8762)
  • [pylint] - add unnecessary-list-index-lookup (PLR1736) + autofix (#7999)
  • [pylint] - implement R0202 and R0203 with autofixes (#8335)
  • [pylint] Implement repeated-keyword (PLe1132) (#8706)
  • [pylint] Implement too-many-positional (PLR0917) (#8995)
  • [pylint] Implement unnecessary-dict-index-lookup (PLR1733) (#8036)
  • [refurb] Implement redundant-log-base (FURB163) (#8842)

Rule changes

  • [flake8-boolean-trap] Allow booleans in @override methods (#8882)
  • [flake8-bugbear] Avoid B015,B018 for last expression in a cell (#8815)
  • [flake8-pie] Allow ellipses for enum values in stub files (#8825)
  • [flake8-pyi] Check PEP 695 type aliases for snake-case-type-alias and t-suffixed-type-alias (#8966)
  • [flake8-pyi] Check for kwarg and vararg NoReturn type annotations (#8948)
  • [flake8-simplify] Omit select context managers from SIM117 (#8801)
  • [pep8-naming] Allow Django model loads in non-lowercase-variable-in-function (N806) (#8917)
  • [pycodestyle] Avoid E703 for last expression in a cell (#8821)
  • [pycodestyle] Update E402 to work at cell level for notebooks (#8872)
  • [pydocstyle] Avoid D100 for Jupyter Notebooks (#8816)
  • [pylint] Implement fix for unspecified-encoding (PLW1514) (#8928)

Formatter

  • Avoid unstable formatting in ellipsis-only body with trailing comment (#8984)
  • Inline trailing comments for type alias similar to assignments (#8941)
  • Insert trailing comma when function breaks with single argument (#8921)

CLI

  • Update ruff check and ruff format to default to the current directory (#8791)
  • Stop at the first resolved parent configuration (#8864)

Configuration

  • [pylint] Default max-positional-args to max-args (#8998)
  • [pylint] Add allow-dunder-method-names setting for bad-dunder-method-name (PLW3201) (#8812)
  • [isort] Add support for from-first setting (#8663)
  • [isort] Add support for length-sort settings (#8841)

Bug fixes

  • Add support for @functools.singledispatch (#8934)
  • Avoid off-by-one error in stripping noqa following multi-byte char (#8979)
  • Avoid off-by-one error in with-item named expressions (#8915)
  • Avoid syntax error via invalid ur string prefix (#8971)
  • Avoid underflow in get_model matching (#8965)
  • Avoid unnecessary index diagnostics when value is modified (#8970)
  • Convert over-indentation rule to use number of characters (#8983)
  • Detect implicit returns in auto-return-types (#8952)
  • Fix start >= end error in over-indentation (#8982)
  • Ignore @overload and @override methods for too-many-arguments checks (#8954)
  • Lexer start of line is false only for Mode::Expression (#8880)
  • Mark pydantic_settings.BaseSettings as having default copy semantics (#8793)
  • Respect dictionary unpacking in NamedTuple assignments (#8810)
  • Respect local subclasses in flake8-type-checking (#8768)
  • Support type alias statements in simple statement positions (#8916)
  • [flake8-annotations] Avoid filtering out un-representable types in return annotation (#8881)
  • [flake8-pie] Retain extra ellipses in protocols and abstract methods (#8769)
  • [flake8-pyi] Respect local enum subclasses in simple-defaults (PYI052) (#8767)
  • [flake8-trio] Use correct range for TRIO115 fix (#8933)
  • [flake8-trio] Use full arguments range for zero-sleep-call (#8936)
  • [isort] fix: mark __main__ as first-party import (#8805)
  • [pep8-naming] Avoid N806 errors for type alias statements (#8785)
  • [perflint] Avoid PERF101 if there's an append in loop body (#8809)
  • [pycodestyle] Allow space-before-colon after end-of-slice (#8838)
  • [pydocstyle] Avoid non-character breaks in over-indentation (D208) (#8866)
  • [pydocstyle] Ignore underlines when determining docstring logical lines (#8929)
  • [pylint] Extend self-assigning-variable to multi-target assignments (#8839)
  • [tryceratops] Avoid repeated triggers in nested tryceratops diagnostics (#8772)

Documentation

  • Add advice for fixing RUF008 when mutability is not desired (#8853)
  • Added the command to run ruff using pkgx to the installation.md (#8955)
  • Document fix safety for flake8-comprehensions and some pyupgrade rules (#8918)
  • Fix doc formatting for zero-sleep-call (#8937)
  • Remove duplicate imports from os-stat documentation (#8930)
  • Replace generated reference to MkDocs (#8806)
  • Update Arch Linux package URL in installation.md (#8802)
  • [flake8-pyi] Fix error in t-suffixed-type-alias (PYI043) example (#8963)
  • [flake8-pyi] Improve motivation for custom-type-var-return-type (PYI019) (#8766)

0.1.6

Preview features

  • [flake8-boolean-trap] Extend boolean-type-hint-positional-argument (FBT001) to include booleans in unions (#7501)
  • [flake8-pie] Extend reimplemented-list-builtin (PIE807) to dict reimplementations (#8608)
  • [flake8-pie] Extend unnecessary-pass (PIE790) to include ellipses (...) (#8641)
  • [flake8-pie] Implement fix for unnecessary-spread (PIE800) (#8668)
  • [flake8-quotes] Implement unnecessary-escaped-quote (Q004) (#8630)
  • [pycodestyle] Implement fix for multiple-spaces-after-keyword (E271) and multiple-spaces-before-keyword (E272) (#8622)
  • [pycodestyle] Implement fix for multiple-spaces-after-operator (E222) and multiple-spaces-before-operator (E221) (#8623)
  • [pyflakes] Extend is-literal (F632) to include comparisons against mutable initializers (#8607)
  • [pylint] Implement redefined-argument-from-local (PLR1704) (#8159)
  • [pylint] Implement fix for unnecessary-lambda (PLW0108) (#8621)
  • [refurb] Implement if-expr-min-max (FURB136) (#8664)
  • [refurb] Implement math-constant (FURB152) (#8727)

Rule changes

  • [flake8-annotations] Add autotyping-like return type inference for annotation rules (#8643)
  • [flake8-future-annotations] Implement fix for future-required-type-annotation (FA102) (#8711)
  • [flake8-implicit-namespace-package] Avoid missing namespace violations in scripts with shebangs (#8710)
  • [pydocstyle] Update over-indentation (D208) to preserve indentation offsets when fixing overindented lines (#8699)
  • [pyupgrade] Refine timeout-error-alias (UP041) to remove false positives (#8587)

Formatter

  • Fix instability in await formatting with fluent style (#8676)
  • Compare formatted and unformatted ASTs during formatter tests (#8624)
  • Preserve trailing semicolon for Notebooks (#8590)

CLI

  • Improve debug printing for resolving origin of config settings (#8729)
  • Write unchanged, excluded files to stdout when read via stdin (#8596)

Configuration

  • [isort] Support disabling sections with no-sections = true (#8657)
  • [pep8-naming] Support local and dynamic class- and static-method decorators (#8592)
  • [pydocstyle] Allow overriding pydocstyle convention rules (#8586)

Bug fixes

  • Avoid syntax error via importing trio.lowlevel (#8730)
  • Omit unrolled augmented assignments in PIE794 (#8634)
  • Slice source code instead of generating it for EM fixes (#7746)
  • Allow whitespace around colon in slices for whitespace-before-punctuation (E203) (#8654)
  • Use function range for no-self-use (#8637)
  • F-strings doesn't contain bytes literal for PLW0129 (#8675)
  • Improve detection of TYPE_CHECKING blocks imported from typing_extensions or _typeshed (#8429)
  • Treat display as a builtin in IPython (#8707)
  • Avoid FURB113 autofix if comments are present (#8494)
  • Consider the new f-string tokens for flake8-commas (#8582)
  • Remove erroneous bad-dunder-name reference (#8742)
  • Avoid recommending Self usages in metaclasses (#8639)
  • Detect runtime-evaluated base classes defined in the current file (#8572)
  • Avoid inserting trailing commas within f-strings (#8574)
  • Remove incorrect deprecation label for stdout and stderr (#8743)
  • Fix unnecessary parentheses in UP007 fix (#8610)
  • Remove repeated and erroneous scoped settings headers in docs (#8670)
  • Trim trailing empty strings when converting to f-strings (#8712)
  • Fix ordering for force-sort-within-sections (#8665)
  • Run unicode prefix rule over tokens (#8709)
  • Update UP032 to unescape curly braces in literal parts of converted strings (#8697)
  • List all ipython builtins (#8719)

Documentation

  • Document conventions in the FAQ (#8638)
  • Redirect from rule codes to rule pages in docs (#8636)
  • Fix permalink to convention setting (#8575)

0.1.5

Preview features

  • [flake8-bandit] Implement mako-templates (S702) (#8533)
  • [flake8-trio] Implement TRIO105 (#8490)
  • [flake8-trio] Implement TRIO109 (#8534)
  • [flake8-trio] Implement TRIO110 (#8537)
  • [flake8-trio] Implement TRIO115 (#8486)
  • [refurb] Implement type-none-comparison (FURB169) (#8487)
  • Flag all comparisons against builtin types in E721 (#8491)
  • Make SIM118 fix as safe when the expression is a known dictionary (#8525)

Formatter

  • Fix multiline lambda expression statement formatting (#8466)

CLI

  • Add hidden --extension to override inference of source type from file extension (#8373)

Configuration

  • Account for selector specificity when merging extend_unsafe_fixes and override extend_safe_fixes (#8444)
  • Add support for disabling cache with RUFF_NO_CACHE environment variable (#8538)

Bug fixes

  • [E721] Flag comparisons to memoryview (#8485)
  • Allow collapsed-ellipsis bodies in other statements (#8499)
  • Avoid D301 autofix for u prefixed strings (#8495)
  • Only flag flake8-trio rules when trio import is present (#8550)
  • Reject more syntactically invalid Python programs (#8524)
  • Avoid raising TRIO115 violations for trio.sleep(...) calls with non-number values (#8532)
  • Fix F841 false negative on assignment to multiple variables (#8489)

Documentation

  • Fix link to isort known-first-party (#8562)
  • Add notes on fix safety to a few rules (#8500)
  • Add missing toml config tabs (#8512)
  • Add instructions for configuration of Emacs (#8488)
  • Improve detail link contrast in dark mode (#8548)
  • Fix typo in example (#8506)
  • Added tabs for configuration files in the documentation (#8480)
  • Recommend project.requires-python over target-version (#8513)
  • Add singleton escape hatch to B008 documentation (#8501)
  • Fix tab configuration docs (#8502)

0.1.4

Preview features

  • [flake8-trio] Implement timeout-without-await (TRIO001) (#8439)
  • [numpy] Implement NumPy 2.0 migration rule (NPY200) (#7702)
  • [pylint] Implement bad-open-mode (W1501) (#8294)
  • [pylint] Implement import-outside-toplevel (C0415) rule (#5180)
  • [pylint] Implement useless-with-lock (W2101) (#8321)
  • [pyupgrade] Implement timeout-error-alias (UP041) (#8476)
  • [refurb] Implement isinstance-type-none (FURB168) (#8308)
  • Detect confusable Unicode-to-Unicode units in RUF001, RUF002, and RUF003 (#4430)
  • Add newline after module docstrings in preview style (#8283)

Formatter

  • Add a note on line-too-long to the formatter docs (#8314)
  • Preserve trailing statement semicolons when using fmt: skip (#8273)
  • Preserve trailing semicolons when using fmt: off (#8275)
  • Avoid duplicating linter-formatter compatibility warnings (#8292)
  • Avoid inserting a newline after function docstrings (#8375)
  • Insert newline between docstring and following own line comment (#8216)
  • Split tuples in return positions by comma first (#8280)
  • Avoid treating byte strings as docstrings (#8350)
  • Add --line-length option to format command (#8363)
  • Avoid parenthesizing unsplittable because of comments (#8431)

CLI

  • Add --output-format to ruff rule and ruff linter (#8203)

Bug fixes

  • Respect --force-exclude in lint.exclude and format.exclude (#8393)
  • Respect --extend-per-file-ignores on the CLI (#8329)
  • Extend bad-dunder-method-name to permit __index__ (#8300)
  • Fix panic with 8 in octal escape (#8356)
  • Avoid raising D300 when both triple quote styles are present (#8462)
  • Consider unterminated f-strings in FStringRanges (#8154)
  • Avoid including literal shell=True for truthy, non-True diagnostics (#8359)
  • Avoid triggering single-element test for starred expressions (#8433)
  • Detect and ignore Jupyter automagics (#8398)
  • Fix invalid E231 error with f-strings (#8369)
  • Avoid triggering NamedTuple rewrite with starred annotation (#8434)
  • Avoid un-setting bracket flag in logical lines (#8380)
  • Place 'r' prefix before 'f' for raw format strings (#8464)
  • Remove trailing periods from NumPy 2.0 code actions (#8475)
  • Fix bug where PLE1307 was raised when formatting %c with characters (#8407)
  • Remove unicode flag from comparable (#8440)
  • Improve B015 message (#8295)
  • Use fixedOverflowWidgets for playground popover (#8458)
  • Mark byte_bounds as a non-backwards-compatible NumPy 2.0 change (#8474)

Internals

  • Add a dedicated cache directory per Ruff version (#8333)
  • Allow selective caching for --fix and --diff (#8316)
  • Improve performance of comment parsing (#8193)
  • Improve performance of string parsing (#8227)
  • Use a dedicated sort key for isort import sorting (#7963)

0.1.3

This release includes a variety of improvements to the Ruff formatter, removing several known and unintentional deviations from Black.

Formatter

  • Avoid space around pow for None, True and False (#8189)
  • Avoid sorting all paths in the format command (#8181)
  • Insert necessary blank line between class and leading comments (#8224)
  • Avoid introducing new parentheses in annotated assignments (#8233)
  • Refine the warnings about incompatible linter options (#8196)
  • Add test and basic implementation for formatter preview mode (#8044)
  • Refine warning about incompatible isort settings (#8192)
  • Only omit optional parentheses for starting or ending with parentheses (#8238)
  • Use source type to determine parser mode for formatting (#8205)
  • Don't warn about magic trailing comma when isort.force-single-line is true (#8244)
  • Use SourceKind::diff for formatter (#8240)
  • Fix fmt:off with trailing child comment (#8234)
  • Formatter parentheses support for IpyEscapeCommand (#8207)

Linter

  • [pylint] Add buffer methods to bad-dunder-method-name (PLW3201) exclusions (#8190)
  • Match rule prefixes from external codes setting in unused-noqa (#8177)
  • Use line-length setting for isort in lieu of pycodestyle.max-line-length (#8235)
  • Update fix for unnecessary-paren-on-raise-exception to unsafe for unknown types (#8231)
  • Correct quick fix message for W605 (#8255)

Documentation

  • Fix typo in max-doc-length documentation (#8201)
  • Improve documentation around linter-formatter conflicts (#8257)
  • Fix link to error suppression documentation in unused-noqa (#8172)
  • Add external option to unused-noqa documentation (#8171)
  • Add title attribute to icons (#8060)
  • Clarify unsafe case in RSE102 (#8256)
  • Fix skipping formatting examples (#8210)
  • docs: fix name of magic-trailing-comma option in README (#8200)
  • Add note about scope of rule changing in versioning policy (#8169)
  • Document: Fix default lint rules (#8218)
  • Fix a wrong setting in configuration.md (#8186)
  • Fix misspelled TOML headers in the tutorial (#8209)

0.1.2

This release includes the Beta version of the Ruff formatter — an extremely fast, Black-compatible Python formatter. Try it today with ruff format! Check out the blog post and read the docs.

Preview features

  • [pylint] Implement non-ascii-module-import (C2403) (#8056)
  • [pylint] implement non-ascii-name (C2401) (#8038)
  • [pylint] Implement unnecessary-lambda (W0108) (#7953)
  • [refurb] Implement read-whole-file (FURB101) (#7682)
  • Add fix for E223, E224, and E242 (#8143)
  • Add fix for E225, E226, E227, and E228 (#8136)
  • Add fix for E252 (#8142)
  • Add fix for E261 (#8114)
  • Add fix for E273 and E274 (#8144)
  • Add fix for E275 (#8133)
  • Update SIM401 to catch ternary operations (#7415)
  • Update E721 to allow is and is not for direct type comparisons (#7905)

Rule changes

  • Add backports.strenum to deprecated-imports (#8113)
  • Update SIM112 to ignore https_proxy, http_proxy, and no_proxy (#8140)
  • Update fix for literal-membership (PLR6201) to be unsafe (#8097)
  • Update fix for mutable-argument-defaults (B006) to be unsafe (#8108)

Formatter

  • Change line-ending default to auto (#8057)
  • Respect parenthesized generators in has_own_parentheses (#8100)
  • Add caching to formatter (#8089)
  • Remove --line-length option from format command (#8131)
  • Add formatter to line-length documentation (#8150)
  • Warn about incompatible formatter options (#8088)
  • Fix range of unparenthesized tuple subject in match statement (#8101)
  • Remove experimental formatter warning (#8148)
  • Don't move type param opening parenthesis comment (#8163)
  • Update versions in format benchmark script (#8110)
  • Avoid loading files for cached format results (#8134)

CLI

  • Show the ruff format command in help menus (#8167)
  • Add ruff version command with long version display (#8034)

Configuration

  • New pycodestyle.max-line-length option (#8039)

Bug fixes

  • Detect sys.version_info slices in outdated-version-block (#8112)
  • Avoid if-else simplification for TYPE_CHECKING blocks (#8072)
  • Avoid false-positive print separator diagnostic with starred argument (#8079)

Documentation

  • Fix message for too-many-arguments lint (#8092)
  • Fix extend-unsafe-fixes and extend-safe-fixes example (#8139)
  • Add links to flake8-import-conventions options (#8115)
  • Rework the documentation to incorporate the Ruff formatter (#7732)
  • Fix Options JSON schema description (#8081)
  • Fix typo (pytext -> pytest) (#8117)
  • Improve magic-value-comparison example in docs (#8111)

0.1.1

Rule changes

  • Add unsafe fix for escape-sequence-in-docstring (D301) (#7970)

Configuration

  • Respect #(deprecated) attribute in configuration options (#8035)
  • Add [format|lint].exclude options (#8000)
  • Respect tab-size setting in formatter (#8006)
  • Add lint.preview (#8002)

Preview features

  • [pylint] Implement literal-membership (PLR6201) (#7973)
  • [pylint] Implement too-many-boolean-expressions (PLR0916) (#7975)
  • [pylint] Implement misplaced-bare-raise (E0704) (#7961)
  • [pylint] Implement global-at-module-level (W0604) (#8058)
  • [pylint] Implement unspecified-encoding (PLW1514) (#7939)
  • Add fix for triple-single-quotes (D300) (#7967)

Formatter

  • New code style badge for ruff format (#7878)
  • Fix comments outside expression parentheses (#7873)
  • Add --target-version to ruff format (#8055)
  • Skip over parentheses when detecting in keyword (#8054)
  • Add --diff option to ruff format (#7937)
  • Insert newline after nested function or class statements (#7946)
  • Use pass over ellipsis in non-function/class contexts (#8049)

Bug fixes

  • Lazily evaluate all PEP 695 type alias values (#8033)
  • Avoid failed assertion when showing fixes from stdin (#8029)
  • Avoid flagging HTTP and HTTPS literals in urllib-open (#8046)
  • Avoid flagging bad-dunder-method-name for _ (#8015)
  • Remove Python 2-only methods from URLOpen audit (#8047)
  • Use set bracket replacement for iteration-over-set to preserve whitespace and comments (#8001)

Documentation

  • Update tutorial to match revised Ruff defaults (#8066)
  • Update rule B005 docs (#8028)
  • Update GitHub actions example in docs to use --output-format (#8014)
  • Document lint.preview and format.preview (#8032)
  • Clarify that new rules should be added to RuleGroup::Preview. (#7989)

0.1.0

This is the first release which uses the CHANGELOG file. See GitHub Releases for prior changelog entries.

Read Ruff's new versioning policy.

Breaking changes

  • Unsafe fixes are no longer displayed or applied without opt-in (#7769)
  • Drop formatting specific rules from the default set (#7900)
  • The deprecated format setting has been removed (#7984)
    • The format setting cannot be used to configure the output format, use output-format instead
    • The RUFF_FORMAT environment variable is ignored, use RUFF_OUTPUT_FORMAT instead
    • The --format option has been removed from ruff check, use --output-format instead

Rule changes

  • Extend reimplemented-starmap (FURB140) to catch calls with a single and starred argument (#7768)
  • Improve cases covered by RUF015 (#7848)
  • Update SIM15 to allow open followed by close (#7916)
  • Respect msgspec.Struct default-copy semantics in RUF012 (#7786)
  • Add sqlalchemy methods to `flake8-boolean-trap`` exclusion list (#7874)
  • Add fix for PLR1714 (#7910)
  • Add fix for PIE804 (#7884)
  • Add fix for PLC0208 (#7887)
  • Add fix for PYI055 (#7886)
  • Update non-pep695-type-alias to require --unsafe-fixes outside of stub files (#7836)
  • Improve fix message for UP018 (#7913)
  • Update PLW3201 to support Enum sunder names (#7987)

Preview features

  • Only show warnings for empty preview selectors when enabling rules (#7842)
  • Add unnecessary-key-check to simplify key in dct and dct[key] to dct.get(key) (#7895)
  • Add assignment-in-assert to prevent walrus expressions in assert statements (#7856)
  • [refurb] Add single-item-membership-test (FURB171) (#7815)
  • [pylint] Add and-or-ternary (R1706) (#7811)

New rules are added in preview.

Configuration

  • Add unsafe-fixes setting (#7769)
  • Add extend-safe-fixes and extend-unsafe-fixes for promoting and demoting fixes (#7841)

CLI

  • Added --unsafe-fixes option for opt-in to display and apply unsafe fixes (#7769)
  • Fix use of deprecated --format option in warning (#7837)
  • Show changed files when running under --check (#7788)
  • Write summary messages to stderr when fixing via stdin instead of omitting them (#7838)
  • Update fix summary message in check --diff to include unsafe fix hints (#7790)
  • Add notebook cell field to JSON output format (#7664)
  • Rename applicability levels to Safe, Unsafe, and Display (#7843)

Bug fixes

  • Fix bug where f-strings were allowed in match pattern literal (#7857)
  • Fix SIM110 with a yield in the condition (#7801)
  • Preserve trailing comments in C414 fixes (#7775)
  • Check sequence type before triggering unnecessary-enumerate len suggestion (#7781)
  • Use correct start location for class/function clause header (#7802)
  • Fix incorrect fixes for SIM101 (#7798)
  • Format comment before parameter default correctly (#7870)
  • Fix E251 false positive inside f-strings (#7894)
  • Allow bindings to be created and referenced within annotations (#7885)
  • Show per-cell diffs when analyzing notebooks over stdin (#7789)
  • Avoid curly brace escape in f-string format spec (#7780)
  • Fix lexing single-quoted f-string with multi-line format spec (#7787)
  • Consider nursery rules to be in-preview for ruff rule (#7812)
  • Report precise location for invalid conversion flag (#7809)
  • Visit pattern match guard as a boolean test (#7911)
  • Respect --unfixable in ISC rules (#7917)
  • Fix edge case with PIE804 (#7922)
  • Show custom message in PTH118 for Path.joinpath with starred arguments (#7852)
  • Fix false negative in outdated-version-block when using greater than comparisons (#7920)
  • Avoid converting f-strings within Django gettext calls (#7898)
  • Fix false positive in PLR6301 (#7933)
  • Treat type aliases as typing-only expressions e.g. resolves false positive in TCH004 (#7968)
  • Resolve cache-dir relative to project root (#7962)
  • Respect subscripted base classes in type-checking rules e.g. resolves false positive in TCH003 (#7954)
  • Fix JSON schema limit for line-length (#7883)
  • Fix commented-out coalesce keyword (#7876)

Documentation

  • Document reimplemented-starmap performance effects (#7846)
  • Default to following the system dark/light mode (#7888)
  • Add documentation for fixes (#7901)
  • Fix typo in docs of PLR6301 (#7831)
  • Update UP038 docs to note that it results in slower code (#7872)
  • crlf -> cr-lf (#7766)
  • Add an example of an unsafe fix (#7924)
  • Fix documented examples for unnecessary-subscript-reversal (#7774)
  • Correct error in tuple example in ruff formatter docs (#7822)
  • Add versioning policy to documentation (#7923)
  • Fix invalid code in FURB177 example (#7832)

Formatter

  • Less scary ruff format message (#7867)
  • Remove spaces from import statements (#7859)
  • Formatter quoting for f-strings with triple quotes (#7826)
  • Update ruff_python_formatter generate.py comment (#7850)
  • Document one-call chaining deviation (#7767)
  • Allow f-string modifications in line-shrinking cases (#7818)
  • Add trailing comment deviation to README (#7827)
  • Add trailing zero between dot and exponential (#7956)
  • Force parentheses for power operations in unary expressions (#7955)

Playground

  • Fix playground Quick Fix action (#7824)