Skip to content

Releases: astral-sh/ruff

v0.1.4

03 Nov 21:39
@github-actions github-actions
v0.1.4
c488919
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.1.4

Changes

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)

Contributors

Assets 34

v0.1.3

26 Oct 19:31
@github-actions github-actions
v0.1.3
3e7b929
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.1.3

This release includes a variety of improvements to the Ruff formatter (available now as ruff format), removing several known and unintentional deviations from Black.

Changes

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)

Contributors

Assets 34

v0.1.2

24 Oct 15:56
@github-actions github-actions
v0.1.2
3127c79
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.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.

Changes

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)

Contributors

Assets 34

v0.1.1

19 Oct 21:24
@github-actions github-actions
v0.1.1
22cf451
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.1.1

Changes

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)

Contributors

Assets 34

v0.1.0

16 Oct 19:51
@github-actions github-actions
v0.1.0
172ac2c
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.1.0

Read the blog post about this release.

Read Ruff's new versioning policy.

This is the first release which uses the CHANGELOG file — change entries will be listed there and in each GitHub Release.

Changes

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)

Contributors

Read more
Assets 34

v0.0.292

02 Oct 17:15
@github-actions github-actions
v0.0.292
c6d0bdd
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.0.292

What's Changed

Highlights

This release includes full support for Python 3.12 (out now!), including the new type parameter (PEP 695) and f-string syntaxes (PEP 701).

PEP 701 lifts many of the restrictions on f-strings that existed in the past, allowing for arbitrarily nested f-strings, consistent quote style within f-strings, and more, all of which are now supported by Ruff (thanks to @dhruvmanila in #7376).

Breaking Changes

  • In the formatter, format.quote-style no longer affects triple-quoted strings, to align with common conventions as well as the guidance from PEP 8 and PEP 257 (see: #7680).
  • line-too-long (E501) now ignores trailing pragma comments (like # type: ignore and # noqa) when computing line length (see: #7692). This is similar to flake8-bugbear's methodology for detecting overlong lines, and ensures that adding pragmas like # noqa does not introduce further lint errors.

Rules

  • [refurb] Implement print-empty-string (FURB105) by @tjkuson in #7617
  • [flake8-bandit] Implement weak-cryptographic-key (S505) by @mkniewallner in #7703
  • [refurb] Implement implicit-cwd (FURB177) by @danparizher in #7704
  • unnecessary-pass (PIE790) now flags all unnecessary pass statements; previously, the rule only flagged pass statements that followed a docstring in a two-statement body (see: #7697).

Settings

Bug Fixes

Other Changes

New Contributors

Full Changelog: v0.0.291...v0.0.292

Contributors

MichaReiser, charliermarsh, and 10 other contributors
Assets 34

v0.0.291

22 Sep 18:14
@github-actions github-actions
v0.0.291
8bfe9bd
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.0.291

What's Changed

Deprecations

The format command-line argument and configuration option has been renamed to output-format. While Ruff will continue to respect format when passed as a command-line argument or configuration option, this backwards-compatible support will be dropped in a future release. See: #7514.

Rules

Settings

Bug Fixes

New Contributors

Full Changelog: v0.0.290...v0.0.291

Contributors

jaap3, MichaReiser, and 12 other contributors
Assets 34

v0.0.290

15 Sep 21:51
@github-actions github-actions
v0.0.290
0c030b5
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.0.290

What's Changed

Rules

  • Update deprecated-import lists based on recent typing-extensions release by @charliermarsh in #7356
  • Add support for bounds, constraints, and explicit variance on generic type variables to UP040 by @nathanwhit in #6749

Settings

Bug Fixes

Preview

What's this section?

New Contributors

Full Changelog: v0.0.289...v0.0.290

Contributors

jelly, charliermarsh, and 4 other contributors
Assets 34

v0.0.289

12 Sep 16:45
@github-actions github-actions
v0.0.289
e7a2779
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.0.289

What's Changed

Bug Fixes

Preview

This release includes a new preview mode which can be used to opt-in to unstable rules and features.

  • Update rule selection to respect preview mode by @zanieb in #7195
  • Display the --preview option in the CLI help menu by @zanieb in #7274

See the documentation and versioning discussion for more details.

New Contributors

Full Changelog: v0.0.288...v0.0.289

Contributors

charliermarsh, zanieb, and 2 other contributors
Assets 34

v0.0.288

11 Sep 17:05
@github-actions github-actions
v0.0.288
7c9bbcf
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.0.288

What's Changed

Breaking Changes

Rules

Settings

  • [flake8-self]
    • SLF001: Add extend-ignore-names option by @jaap3 in #7194

Bug Fixes

Other Changes

New Contributors

Full Changelog: v0.0.287...v0.0.288

Contributors

jaap3, MichaReiser, and 12 other contributors
Assets 34