Change the name of the message.

mbyrnepr2 · mbyrnepr2 · commit 43b300abbcf2 · 2025-08-04T09:28:38.000+02:00
diff --git a/doc/data/messages/b/bare-name-capture-pattern/bad.py b/doc/data/messages/b/bare-name-capture-pattern/bad.py
@@ -5,9 +5,9 @@
 
 color = blue
 match color:
-    case red:  # [unreachable-match-patterns]
+    case red:  # [bare-name-capture-pattern]
         print("I see red!")
-    case green:  # [unreachable-match-patterns]
+    case green:  # [bare-name-capture-pattern]
         print("Grass is green")
     case blue:
         print("I'm feeling the blues :(")
diff --git a/doc/data/messages/b/bare-name-capture-pattern/good.py b/doc/data/messages/b/bare-name-capture-pattern/good.py
diff --git a/doc/data/messages/b/bare-name-capture-pattern/related.rst b/doc/data/messages/b/bare-name-capture-pattern/related.rst
diff --git a/doc/data/ruff.toml b/doc/data/ruff.toml
@@ -5,7 +5,7 @@ line-length = 103
 extend-exclude = [
     "messages/d/duplicate-argument-name/bad.py",
     "messages/s/syntax-error/bad.py",
-    "messages/u/unreachable-match-patterns/bad.py",
+    "messages/b/bare-name-capture-pattern/bad.py",
     # syntax error in newer python versions
     "messages/s/star-needs-assignment-target/bad.py",
     "messages/i/invalid-star-assignment-target/bad.py",
diff --git a/doc/user_guide/checkers/features.rst b/doc/user_guide/checkers/features.rst
@@ -680,7 +680,7 @@ Verbatim name of the checker is ``match_statements``.
 
 Match Statements checker Messages
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-:unreachable-match-patterns (E1901): *The name capture `case %s` makes the remaining patterns unreachable. Use a dotted name (for example an enum) to fix this.*
+:bare-name-capture-pattern (E1901): *The name capture `case %s` makes the remaining patterns unreachable. Use a dotted name (for example an enum) to fix this.*
   Emitted when a name capture pattern in a match statement is used and there
   are case statements below it.
 
diff --git a/doc/user_guide/messages/messages_overview.rst b/doc/user_guide/messages/messages_overview.rst
@@ -63,6 +63,7 @@ All messages in the error category:
    error/bad-str-strip-call
    error/bad-string-format-type
    error/bad-super-call
+   error/bare-name-capture-pattern
    error/bidirectional-unicode
    error/broken-collections-callable
    error/broken-noreturn
@@ -165,7 +166,6 @@ All messages in the error category:
    error/unexpected-special-method-signature
    error/unhashable-member
    error/unpacking-non-sequence
-   error/unreachable-match-patterns
    error/unrecognized-inline-option
    error/unrecognized-option
    error/unsubscriptable-object
diff --git a/doc/whatsnew/fragments/7128.new_check b/doc/whatsnew/fragments/7128.new_check
@@ -1,5 +1,5 @@
 Add ``match-statements`` checker and the following message:
-``unreachable-match-patterns``.
+``bare-name-capture-pattern``.
 This will emit an error message when a name capture pattern is used in a match statement which would make the remaining patterns unreachable.
 This code is a SyntaxError at runtime.
 
diff --git a/pylint/checkers/match_statements_checker.py b/pylint/checkers/match_statements_checker.py
@@ -24,13 +24,13 @@ class MatchStatementChecker(BaseChecker):
         "E1901": (
             "The name capture `case %s` makes the remaining patterns unreachable. "
             "Use a dotted name (for example an enum) to fix this.",
-            "unreachable-match-patterns",
+            "bare-name-capture-pattern",
             "Emitted when a name capture pattern in a match statement is used "
             "and there are case statements below it.",
         )
     }
 
-    @only_required_for_messages("unreachable-match-patterns")
+    @only_required_for_messages("bare-name-capture-pattern")
     def visit_match(self, node: nodes.Match) -> None:
         """Check if a name capture pattern prevents the other cases from being
         reached.
@@ -43,7 +43,7 @@ def visit_match(self, node: nodes.Match) -> None:
                 and idx < len(node.cases) - 1
             ):
                 self.add_message(
-                    "unreachable-match-patterns",
+                    "bare-name-capture-pattern",
                     node=case,
                     args=case.pattern.name.name,
                     confidence=HIGH,
diff --git a/tests/functional/b/bare_name_capture_pattern.py b/tests/functional/b/bare_name_capture_pattern.py
@@ -0,0 +1,15 @@
+"""Functional tests for the ``bare-name-capture-pattern`` message"""
+
+
+a = 'a'
+b = 'b'
+s = 'a'
+
+
+match s:
+    case a:  # [bare-name-capture-pattern]
+        pass
+    case b:  # [bare-name-capture-pattern]
+        pass
+    case s:
+        pass
diff --git a/tests/functional/b/bare_name_capture_pattern.txt b/tests/functional/b/bare_name_capture_pattern.txt
@@ -0,0 +1,2 @@
+bare-name-capture-pattern:10:0:None:None::The name capture `case a` makes the remaining patterns unreachable. Use a dotted name (for example an enum) to fix this.:HIGH
+bare-name-capture-pattern:12:0:None:None::The name capture `case b` makes the remaining patterns unreachable. Use a dotted name (for example an enum) to fix this.:HIGH
diff --git a/tests/functional/u/unreachable_match_patterns.py b/tests/functional/u/unreachable_match_patterns.py
diff --git a/tests/functional/u/unreachable_match_patterns.txt b/tests/functional/u/unreachable_match_patterns.txt

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	+bare-name-capture-pattern:10:0:None:None::The name capture `case a` makes the remaining patterns unreachable. Use a dotted name (for example an enum) to fix this.:HIGH
	`2`	+bare-name-capture-pattern:12:0:None:None::The name capture `case b` makes the remaining patterns unreachable. Use a dotted name (for example an enum) to fix this.:HIGH