@neralabs/rerail-pack-python 0.1.3 → 0.1.4

package/rules/ruff-f405-undefined-local-with-import-star-usage.json

@@ -3,7 +3,7 @@
   "id": "ruff-f405-undefined-local-with-import-star-usage",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F405 (undefined-local-with-import-star-usage) on the engine's name resolution (M10a `resolves.unresolved: \"star\"`): a reference, or a string entry of a module `__all__`, that no binding in scope and no builtin resolves and that a visible star import may bind, reported on the name or the string; and such a name inside a string Ruff parses as a type definition (M11a `parse` with `annotation`, nested strings included), reported on each such name inside the string.",
+  "description": "Import names explicitly instead of relying on a star import to define them; names that may only come from a star import can't be checked.",
   "scope": {
     "include": [
       "**/*"
@@ -72,7 +72,7 @@
       "violation": {
         "anchor": "capture.NAME",
         "code": "F405",
-        "message": "`$NAME` may be undefined, or defined from star imports",
+        "message": "Import `$NAME` explicitly from its module; it may only be defined by a star import.",
         "each": "NAME",
         "suppress": {
           "noqa": {

package/rules/ruff-f406-undefined-local-with-nested-import-star-usage.json

@@ -3,7 +3,7 @@
   "id": "ruff-f406-undefined-local-with-nested-import-star-usage",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F406 (undefined-local-with-nested-import-star-usage): a `from <module> import *` outside module scope, i.e. anywhere inside a function or class body, reported on the whole statement.",
+  "description": "Don't use from module import * inside a function or class; star imports are only allowed at module level.",
   "scope": { "include": ["**/*"], "exclude": [] },
   "clauses": [
     {
@@ -25,7 +25,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F406",
-        "message": "`from $MODULE import *` only allowed at module level",
+        "message": "Import the needed names from `$MODULE` explicitly; a star import is only allowed at module level.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f407-future-feature-not-defined.json

@@ -3,7 +3,7 @@
   "id": "ruff-f407-future-feature-not-defined",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F407 (future-feature-not-defined): a name imported from `__future__` (also through a relative `from .__future__`, matched by the module's text with `resolves.imported` and `relative: \"text\"`, as Ruff ignores the level) that is not one of CPython's future features (`is_known_future_feature` in ruff_python_parser's semantic_errors.rs), reported on the alias (`name as alias` included) or on the `*` of a star import.",
+  "description": "Import only real feature names from __future__; an unknown feature name is a syntax error.",
   "scope": { "include": ["**/*"], "exclude": [] },
   "clauses": [
     {

package/rules/ruff-f501-percent-format-invalid-format.json

@@ -3,7 +3,7 @@
   "id": "ruff-f501-percent-format-invalid-format",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F501 (percent-format-invalid-format): a `%`-format string the parser refuses for any reason but an unsupported format character (an incomplete specifier, an unclosed mapping key, a width or precision too big). The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) left of `%`, read with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser).",
+  "description": "Fix malformed %-format strings, such as incomplete specifiers or unclosed %(key) names; they raise an error at run time.",
   "scope": {
     "include": [
       "**/*"
@@ -74,7 +74,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F501",
-        "message": "`%`-format string has invalid format string",
+        "message": "Fix this malformed %-format string, such as an incomplete specifier or an unclosed %(key) name.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f502-percent-format-expected-mapping.json

@@ -3,7 +3,7 @@
   "id": "ruff-f502-percent-format-expected-mapping",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F502 (percent-format-expected-mapping): a valid `%`-format string with a `%(key)` placeholder applied to a list, tuple or set display, a list or set comprehension or a generator. The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) left of `%`, read with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser).",
+  "description": "Pass a mapping, not a list, tuple or set, to a %-format string that uses %(key) placeholders; the call fails at run time.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f503-percent-format-expected-sequence.json

@@ -3,7 +3,7 @@
   "id": "ruff-f503-percent-format-expected-sequence",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F503 (percent-format-expected-sequence): a valid `%`-format string consuming more than one positional value (placeholders without a key, and `*` widths and precisions) applied to a dict display or comprehension. The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) left of `%`, read with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser).",
+  "description": "Pass a tuple, not a dict, to a %-format string with several positional placeholders; the call fails at run time.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f504-percent-format-extra-named-arguments.json

@@ -3,7 +3,7 @@
   "id": "ruff-f504-percent-format-extra-named-arguments",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F504 (percent-format-extra-named-arguments): a valid `%`-format string without positional placeholders applied to a dict display without `**` with a string-literal key no `%(key)` placeholder names. `formatArgs` reads the format string left of `%` (a str literal with no f/t/b prefix, implicit concatenations joined, escapes decoded, parentheses transparent) with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser), and the right operand as Ruff's strings.rs does.",
+  "description": "Remove dict keys that no %(key) placeholder in the %-format string uses; an unused key usually means a typo or a stale argument.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f505-percent-format-missing-argument.json

@@ -3,7 +3,7 @@
   "id": "ruff-f505-percent-format-missing-argument",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F505 (percent-format-missing-argument): a valid `%`-format string without positional placeholders applied to a dict display without `**`, all of whose keys are string literals, that passes no value for some `%(key)` placeholder. `formatArgs` reads the format string left of `%` (a str literal with no f/t/b prefix, implicit concatenations joined, escapes decoded, parentheses transparent) with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser), and the right operand as Ruff's strings.rs does.",
+  "description": "Supply a value for every %(key) placeholder in a %-format string; a missing key raises KeyError at run time.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f506-percent-format-mixed-positional-and-named.json

@@ -3,7 +3,7 @@
   "id": "ruff-f506-percent-format-mixed-positional-and-named",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F506 (percent-format-mixed-positional-and-named): a valid `%`-format string with both a `%(key)` placeholder and a positional value (a placeholder without a key, or a `*` width or precision). The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) left of `%`, read with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser).",
+  "description": "Don't mix %(key) placeholders and positional placeholders in one %-format string; Python cannot format it.",
   "scope": {
     "include": [
       "**/*"
@@ -100,7 +100,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F506",
-        "message": "`%`-format string has mixed positional and named placeholders",
+        "message": "Use only %(key) placeholders or only positional ones in this format string; Python cannot format a mix.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f507-percent-format-positional-count-mismatch.json

@@ -3,7 +3,7 @@
   "id": "ruff-f507-percent-format-positional-count-mismatch",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F507 (percent-format-positional-count-mismatch): a valid `%`-format string without `%(key)` placeholders whose positional values differ in number from a tuple display without starred items, or, with any count but one, from a right operand Ruff's ResolvedPythonType infers as one non-tuple value; with no placeholder, any right operand but a tuple display or one Ruff types as a tuple (`(1,) + (2,)`). `formatArgs` reads the format string left of `%` (a str literal with no f/t/b prefix, implicit concatenations joined, escapes decoded, parentheses transparent) with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser), and the right operand as Ruff's strings.rs does. Ported from the Ruff conformance suite (rerail/conformance/ruff/rules/F507.json at 3f102adcb), with Ruff's `# noqa` honoured as the Ruff CLI honours it.",
+  "description": "Match the number of %-format placeholders to the number of values supplied; a mismatch raises TypeError at run time.",
   "scope": {
     "include": [
       "**/*"
@@ -64,7 +64,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F507",
-        "message": "`%`-format string placeholder count differs from the substitution count",
+        "message": "Make the number of values match the placeholders in this %-format string; a mismatch raises TypeError.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f508-percent-format-star-requires-sequence.json

@@ -3,7 +3,7 @@
   "id": "ruff-f508-percent-format-star-requires-sequence",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F508 (percent-format-star-requires-sequence): a valid `%`-format string with a `*` width or precision applied to a dict display or comprehension. The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) left of `%`, read with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser).",
+  "description": "Pass a tuple, not a dict, to a %-format string that uses a * width or precision; the call fails at run time.",
   "scope": {
     "include": [
       "**/*"
@@ -98,7 +98,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F508",
-        "message": "`%`-format string `*` specifier requires sequence",
+        "message": "Pass a tuple instead of a dict to this %-format string; its `*` width or precision takes positional values.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f509-percent-format-unsupported-format-character.json

@@ -3,7 +3,7 @@
   "id": "ruff-f509-percent-format-unsupported-format-character",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F509 (percent-format-unsupported-format-character): a `%`-format string the parser refuses at an unsupported conversion character. The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) left of `%`, read with the `percentFormat` grammar (a port of ruff_python_literal's cformat parser).",
+  "description": "Use only valid conversion characters in Python %-format strings; an unsupported one raises ValueError at runtime.",
   "scope": {
     "include": [
       "**/*"
@@ -72,7 +72,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F509",
-        "message": "`%`-format string has unsupported format character",
+        "message": "Replace the unsupported conversion character in this %-format string with a valid one such as `s`, `d`, `r` or `f`.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f521-string-dot-format-invalid-format.json

@@ -3,7 +3,7 @@
   "id": "ruff-f521-string-dot-format-invalid-format",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F521 (string-dot-format-invalid-format): a `.format` call on a str literal the format parser refuses (unmatched braces, fields nested deeper than one level, an empty attribute or index, an unclosed `[`, a bad conversion or format spec). The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) receiving `.format`, read with the `braceFormat` grammar (a port of ruff_python_literal's format parser as pyflakes' FormatSummary reads it).",
+  "description": "Keep str.format() strings well-formed, with balanced braces and valid fields and format specs; a malformed one raises ValueError at runtime.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f522-string-dot-format-extra-named-arguments.json

@@ -3,7 +3,7 @@
   "id": "ruff-f522-string-dot-format-extra-named-arguments",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F522 (string-dot-format-extra-named-arguments): a `.format` call without `**` on a valid format string, passing a keyword argument no named field (top level or nested in a spec) reads. `formatArgs` reads the format string receiving `.format` (a str literal with no f/t/b prefix, implicit concatenations joined, escapes decoded, parentheses transparent) with the `braceFormat` grammar (a port of ruff_python_literal's format parser as pyflakes' FormatSummary reads it), and the call's arguments as Ruff's strings.rs does.",
+  "description": "Remove keyword arguments to str.format() that no named placeholder in the string uses; they are silently ignored.",
   "scope": {
     "include": [
       "**/*"
@@ -32,7 +32,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F522",
-        "message": "`.format` call has unused named argument(s)",
+        "message": "Remove the keyword arguments that no named placeholder in this str.format() string uses.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f523-string-dot-format-extra-positional-arguments.json

@@ -3,7 +3,7 @@
   "id": "ruff-f523-string-dot-format-extra-positional-arguments",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F523 (string-dot-format-extra-positional-arguments): a `.format` call on a valid format string with a positional argument (not starred; counted by syntactic index, past a starred one too) that no automatic or numbered field reads. `formatArgs` reads the format string receiving `.format` (a str literal with no f/t/b prefix, implicit concatenations joined, escapes decoded, parentheses transparent) with the `braceFormat` grammar (a port of ruff_python_literal's format parser as pyflakes' FormatSummary reads it), and the call's arguments as Ruff's strings.rs does. Ported from the Ruff conformance suite (rerail/conformance/ruff/rules/F523.json at 3f102adcb), with Ruff's `# noqa` honoured as the Ruff CLI honours it.",
+  "description": "Remove positional arguments to str.format() that no placeholder in the string uses; they are silently ignored.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f524-string-dot-format-missing-arguments.json

@@ -3,7 +3,7 @@
   "id": "ruff-f524-string-dot-format-missing-arguments",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F524 (string-dot-format-missing-arguments): a `.format` call without `*` or `**` on a valid format string with a field (top level or nested in a spec) whose index is past the positional arguments or whose name no keyword argument passes. `formatArgs` reads the format string receiving `.format` (a str literal with no f/t/b prefix, implicit concatenations joined, escapes decoded, parentheses transparent) with the `braceFormat` grammar (a port of ruff_python_literal's format parser as pyflakes' FormatSummary reads it), and the call's arguments as Ruff's strings.rs does. Ported from the Ruff conformance suite (rerail/conformance/ruff/rules/F524.json at 3f102adcb), with Ruff's `# noqa` honoured as the Ruff CLI honours it.",
+  "description": "Pass an argument for every placeholder in a str.format() string; a missing one raises IndexError or KeyError at runtime.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f525-string-dot-format-mixing-automatic.json

@@ -3,7 +3,7 @@
   "id": "ruff-f525-string-dot-format-mixing-automatic",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F525 (string-dot-format-mixing-automatic): a `.format` call on a valid format string with both an automatically numbered field (`{}`) and a manually numbered one (`{0}`), nested fields in specs included. The format string is a str literal (no f/t/b prefix; implicit concatenations joined, escapes decoded, parentheses transparent) receiving `.format`, read with the `braceFormat` grammar (a port of ruff_python_literal's format parser as pyflakes' FormatSummary reads it).",
+  "description": "Don't mix automatic and manually numbered fields in one str.format() string; Python raises ValueError at runtime.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f541-f-string-missing-placeholders.json

@@ -3,7 +3,7 @@
   "id": "ruff-f541-f-string-missing-placeholders",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F541 (f-string-missing-placeholders) with default settings: every f-string part of a string expression (an implicit concatenation counts as one expression) when no f-string part of that expression has a replacement field. `{{`/`}}` escapes are not placeholders; nested f-strings inside a replacement field or format spec are their own expressions.",
+  "description": "Remove the f prefix from Python f-strings that have no placeholders; it suggests interpolation that never happens.",
   "scope": { "include": ["**/*"], "exclude": [] },
   "clauses": [
     {
@@ -38,7 +38,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F541",
-        "message": "f-string without any placeholders",
+        "message": "Remove the `f` prefix from this string; it has no placeholders.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f601-multi-value-repeated-key-literal.json

@@ -3,7 +3,7 @@
   "id": "ruff-f601-multi-value-repeated-key-literal",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F601 (multi-value-repeated-key-literal) with default settings: a literal dictionary key (string, bytes, number, boolean, None, Ellipsis, tuple, f-string, signed number, real +/- imaginary; Ruff's is_literal_key) equal to an earlier key of the same dict display, reported on each repeat (parentheses are transparent). Equality is Ruff's HashableExpr (`compare` `text: \"structure-hash\"`): numbers fold by value (`1 == 1.0 == True`, `1 + 0j == 1`), strings by decoded value, tuples of constants element by element, anything else structurally as ComparableExpr (names without NFKC normalization). Ported from the Ruff conformance suite (rerail/conformance/ruff/rules/F601.json at 3f102adcb), with Ruff's `# noqa` honoured as the Ruff CLI honours it.",
+  "description": "Avoid repeating a literal key (or an equal one, like 1 and 1.0) in a Python dict literal; the later value silently overwrites the earlier one.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f602-multi-value-repeated-key-variable.json

@@ -3,7 +3,7 @@
   "id": "ruff-f602-multi-value-repeated-key-variable",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F602 (multi-value-repeated-key-variable) with default settings: a dictionary key that is a bare name equal to an earlier key of the same dict display, reported on each repeat (parentheses transparent).",
+  "description": "Avoid repeating the same variable as a key in a Python dict literal; the later value silently overwrites the earlier one.",
   "scope": {
     "include": [
       "**/*"
@@ -109,7 +109,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F602",
-        "message": "Dictionary key `$KEY` repeated",
+        "message": "Remove or merge the repeated key `$KEY` in this dict; the later value silently overwrites the earlier one.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f622-multiple-starred-expressions.json

@@ -3,7 +3,7 @@
   "id": "ruff-f622-multiple-starred-expressions",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F622 (multiple-starred-expressions, a semantic syntax error) with default settings: a tuple or list assignment target (assignment, `for`, comprehension `for`, `with ... as`), at any nesting, with two or more starred elements of its own. Reported on the target tuple or list, parentheses included.",
+  "description": "Use at most one starred element in each Python unpacking target; two in the same target is a syntax error.",
   "scope": { "include": ["**/*"], "exclude": [] },
   "clauses": [
     {

package/rules/ruff-f632-is-literal.json

@@ -3,7 +3,7 @@
   "id": "ruff-f632-is-literal",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F632 (is-literal) with default settings: `is` or `is not` with an operand that is a non-singleton constant (string, bytes or number literal, tuple of constants) or a list, set or dict display or comprehension, one finding per offending operator reported on the whole comparison, as in Ruff; also a comparison inside a string Ruff parses as a type definition (a string annotation, `cast`/`TypeVar` arguments, `List[\"...\"]`), reported on the comparison inside the string, once per offending operator; strings nested in one (`List['1 is x']` inside a string annotation) are read too. Ported from the Ruff conformance suite (rerail/conformance/ruff/rules/F632.json at 3f102adcb), with Ruff's `# noqa` honoured as the Ruff CLI honours it.",
+  "description": "Use == instead of is to compare against string, number, tuple or container literals; the identity of such values is unreliable.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f633-invalid-print-syntax.json

@@ -3,7 +3,7 @@
   "id": "ruff-f633-invalid-print-syntax",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F633 (invalid-print-syntax) with default settings: the left operand of `>>` when it resolves to the builtin `print` (or `builtins.print`), reported on `print`. tree-sitter-python parses a statement `print >> f, x` as a Python 2 print statement whose `print` is a keyword token, not a name reference, so name resolution cannot be asked there; that form falls back to a file-wide test: no binding of `print` anywhere in the file (assignment, loop, with/except and walrus targets, def/class names, parameters, imports, global/nonlocal).",
+  "description": "Use print()'s file argument instead of Python 2's >> redirection, which raises TypeError with the print function.",
   "scope": {
     "include": [
       "**/*"
@@ -285,7 +285,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F633",
-        "message": "Use of `>>` is invalid with `print` function",
+        "message": "Replace `>>` with print()'s `file=` argument, as in `print(msg, file=sys.stderr)`.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f701-break-outside-loop.json

@@ -3,7 +3,7 @@
   "id": "ruff-f701-break-outside-loop",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F701 (break-outside-loop, a semantic syntax error) with default settings: `break` with no enclosing `for`/`while` body between it and the nearest function or class definition. A loop's `else` block does not count as inside that loop.",
+  "description": "Keep break inside a for or while loop body; outside one (including a loop's else block) it is a Python syntax error.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f702-continue-outside-loop.json

@@ -3,7 +3,7 @@
   "id": "ruff-f702-continue-outside-loop",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F702 (continue-outside-loop, a semantic syntax error) with default settings: `continue` with no enclosing `for`/`while` body between it and the nearest function or class definition. A loop's `else` block does not count as inside that loop.",
+  "description": "Keep continue inside a for or while loop body; outside one (including a loop's else block) it is a Python syntax error.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f706-return-outside-function.json

@@ -3,7 +3,7 @@
   "id": "ruff-f706-return-outside-function",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F706 (return-outside-function, a semantic syntax error) with default settings: `return` whose nearest enclosing function or class body is not a function body (module level, or directly in a class body).",
+  "description": "Keep return inside a function; at module level or directly in a class body it is a Python syntax error.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f707-default-except-not-last.json

@@ -3,7 +3,7 @@
   "id": "ruff-f707-default-except-not-last",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F707 (default-except-not-last) with default settings: a bare `except:` handler followed by another handler of the same `try`. Reported on the `except` keyword.",
+  "description": "Put a bare except handler last in its try statement; Python rejects any handler after it.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f822-undefined-export.json

@@ -3,7 +3,7 @@
   "id": "ruff-f822-undefined-export",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F822 (undefined-export) with default settings, on the engine's name resolution (M10a `resolves.unresolved` on `__all__` entries): a string entry of a static module `__all__` definition (Ruff's extract_dunder_all_names) (an implicit concatenation is one entry) that names no module binding (a bare annotation included) and no builtin, in a module without a star import. `__init__.py` is exempt (Ruff reports it only in preview). Reported on the string.",
+  "description": "List only names the module actually defines in its __all__ (outside __init__.py); an undefined entry breaks star imports.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f823-undefined-local.json

@@ -3,7 +3,7 @@
   "id": "ruff-f823-undefined-local",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F823 (undefined-local) with default settings, on the engine's name resolution (M10a `resolves.beforeLocal`, Ruff's undefined_local): a function's first read of a name that resolves to an enclosing function's or the module's binding which the function's own later binding of the name shadows, where that binding is the function's first and latest of the name (not `global`, `nonlocal` or `del`). Reported on the read. Ported from the Ruff conformance suite (rerail/conformance/ruff/rules/F823.json at 3f102adcb), with Ruff's `# noqa` honoured as the Ruff CLI honours it.",
+  "description": "Don't read a variable before the function assigns it, even when an outer scope has the same name; Python raises UnboundLocalError.",
   "scope": {
     "include": [
       "**/*"
@@ -28,7 +28,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "F823",
-        "message": "Local variable `$N` referenced before assignment",
+        "message": "Assign `$N` before reading it here, or declare it `global` or `nonlocal` if you meant the outer variable.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-f842-unused-annotation.json

@@ -3,7 +3,7 @@
   "id": "ruff-f842-unused-annotation",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F842 (unused-annotation) with default settings (`dummy-variable-rgx` = `^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$`), on the engine's usedness (M10a `binds` with form `annotation`, Ruff's unused_annotation): the latest binding of a name in a function or lambda scope that is a bare annotation (`x: int`, `(x): int`) nothing reads, not a dummy name. Names in strings Ruff parses as type definitions are reads (M11a).",
+  "description": "Remove local variables that are annotated but never assigned or read; the annotation alone does nothing.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-f901-raise-not-implemented.json

@@ -3,7 +3,7 @@
   "id": "ruff-f901-raise-not-implemented",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's F901 (raise-not-implemented) with default settings: the exception of a `raise` (not its `from` cause) that is the name `NotImplemented` or a call whose callee is that name, parentheses transparent. Reported on the name. Ruff matches the name itself, not the builtin binding.",
+  "description": "Raise NotImplementedError, not NotImplemented; NotImplemented is a comparison sentinel and raising it is a TypeError.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-pie794-duplicate-class-field-definition.json

@@ -3,7 +3,7 @@
   "id": "ruff-pie794-duplicate-class-field-definition",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's PIE794 (duplicate-class-field-definition): in a class body, an assignment or annotated assignment to a name `N` whose value does not mention `N`, after an earlier such definition of `N` in the same body.",
+  "description": "Define each class field once; a later definition silently replaces the earlier one.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-pie796-non-unique-enums.json

@@ -3,7 +3,7 @@
   "id": "ruff-pie796-non-unique-enums",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's PIE796 (non-unique-enums): in a class with an `enum.Enum` base, a plain assignment whose value equals the value of an earlier assignment in the same body as Ruff's ComparableExpr (`text: \"structure\"`: literals by type and value, `1 == 0x1`, `'a' == \"a\"`, `-1 == -(1)`, not `1 == 1.0 == True`; names compared without NFKC normalization); `enum.auto()` values (alone or in a tuple) are skipped, and in stubs (`.pyi`) so are `...` and `typing.cast(T, ...)`. Ported from the Ruff conformance suite (rerail/conformance/ruff/rules/PIE796.json at 3f102adcb), with Ruff's `# noqa` honoured as the Ruff CLI honours it, and its `.py`/`.pyi` split read per file (`ast.file.path`): the suite's `select_when` gate holds wherever a matching file exists anywhere in the workspace, so in a repository it would read stubs as modules and modules as stubs.",
+  "description": "Give each Enum member a unique value; a duplicate becomes an alias of the earlier member instead of a new one.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-pie800-unnecessary-spread.json

@@ -3,7 +3,7 @@
   "id": "ruff-pie800-unnecessary-spread",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's PIE800 (unnecessary-spread): a dict display spread with `**` into another dict display, reported on the inner dict (inside any parentheses).",
+  "description": "Write the entries directly instead of spreading a dict literal into another Python dict literal.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-pie804-unnecessary-dict-kwargs.json

@@ -3,7 +3,7 @@
   "id": "ruff-pie804-unnecessary-dict-kwargs",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's PIE804 (unnecessary-dict-kwargs): a call argument `**{...}` whose dict display is a single `**x` spread, empty, or has only keys that are str literals (not bytes, f- or t-strings; escapes decoded, implicit concatenations joined) whose value is a Python identifier (not a keyword). Reported on the `**` argument.",
+  "description": "Pass keyword arguments directly instead of unpacking a dict literal into a Python call.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-pie807-reimplemented-container-builtin.json

@@ -3,7 +3,7 @@
   "id": "ruff-pie807-reimplemented-container-builtin",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's PIE807 (reimplemented-container-builtin): a parameterless `lambda` whose body is an empty list or dict display.",
+  "description": "Use list or dict directly instead of a lambda that returns an empty list or dict, such as for a default factory.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-pie810-multiple-starts-ends-with.json

@@ -3,7 +3,7 @@
   "id": "ruff-pie810-multiple-starts-ends-with",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's PIE810 (multiple-starts-ends-with): an `or` chain with two or more operands `R.startswith(x)` (or two `R.endswith(x)`) on the same name `R`, each with one positional argument and no keywords, where the argument is not a name bound to a tuple (Ruff's is_bound_to_tuple through `resolves.binding`, read as lookup_symbol does with `stopAtGlobal`: a `def`'s `*args`, a tuple-typed value, `tuple(...)`, or a `tuple`/`Tuple` annotation or return annotation). Reported on the whole chain, once per such group.",
+  "description": "Pass a tuple to one startswith() or endswith() call instead of or-ing several calls on the same string.",
   "scope": {
     "include": [
       "**/*"
@@ -570,7 +570,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "PIE810",
-        "message": "Call `$M` once with a `tuple`",
+        "message": "Call `$M` once with a tuple of all the prefixes or suffixes instead of or-ing several calls.",
         "each": "FIRST",
         "suppress": {
           "noqa": {

package/rules/ruff-ret501-unnecessary-return-none.json

@@ -3,7 +3,7 @@
   "id": "ruff-ret501-unnecessary-return-none",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's RET501 (unnecessary-return-none): `return None` in a function whose every `return` is bare or returns `None` (nested functions and classes are separate; generators and functions whose body is a lone `return` are skipped), unless the function has a return annotation other than `None` or a property decorator (`property`, `enum.property`, `functools.cached_property`, `abc.abstractproperty`, `types.DynamicClassAttribute`, resolved through the file's bindings and imports). Reported on the `return` statement.",
+  "description": "Use a bare return instead of return None in Python functions that never return anything else.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-ret502-implicit-return-value.json

@@ -3,7 +3,7 @@
   "id": "ruff-ret502-implicit-return-value",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's RET502 (implicit-return-value): a bare `return` in a function that also has a `return` with a value other than `None` (nested functions and classes are separate; generators and functions whose body is a lone `return` are skipped), reported on the `return`.",
+  "description": "Use return None instead of a bare return in Python functions that also return a value; make the None result explicit.",
   "scope": {
     "include": [
       "**/*"
@@ -149,7 +149,7 @@
       "violation": {
         "anchor": "witness.span",
         "code": "RET502",
-        "message": "Do not implicitly `return None` in function able to return non-`None` value",
+        "message": "Write `return None` instead of a bare `return`, since this function returns a value elsewhere.",
         "suppress": {
           "noqa": {
             "codes": [

package/rules/ruff-ret505-superfluous-else-return.json

@@ -3,7 +3,7 @@
   "id": "ruff-ret505-superfluous-else-return",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's RET505 (superfluous-else-return): the first `elif`/`else` clause of an `if` statement inside a function whose `if` body has a direct `return` statement and no earlier direct raise/continue/break statement, reported on the `elif`/`else` keyword. As in Ruff, only the `if` body and the first clause are compared, nested functions and classes are separate, and generator functions and functions whose body is a lone `return` are skipped.",
+  "description": "Remove the else or elif after an if branch that returns, and dedent its code; the branch already leaves the function.",
   "scope": {
     "include": [
       "**/*"

package/rules/ruff-ret506-superfluous-else-raise.json

@@ -3,7 +3,7 @@
   "id": "ruff-ret506-superfluous-else-raise",
   "revision": 1,
   "mode": "steer",
-  "description": "Port of Ruff's RET506 (superfluous-else-raise): the first `elif`/`else` clause of an `if` statement inside a function whose `if` body has a direct `raise` statement and no earlier direct return/continue/break statement, reported on the `elif`/`else` keyword. As in Ruff, only the `if` body and the first clause are compared, nested functions and classes are separate, and generator functions and functions whose body is a lone `return` are skipped.",
+  "description": "Remove the else or elif after an if branch that raises, and dedent its code; the branch already leaves the function.",
   "scope": {
     "include": [
       "**/*"