gh-151303 : Improve SyntaxError suggestions for common operator typos and cross-language mistakes

Grammar/python.gram

@@ -801,8 +801,11 @@ compare_op_bitwise_or_pair[CmpopExprPair*]:
     | in_bitwise_or
     | isnot_bitwise_or
     | is_bitwise_or
+    | invalid_eqeqeq
 
 eq_bitwise_or[CmpopExprPair*]: '==' a=bitwise_or { _PyPegen_cmpop_expr_pair(p, Eq, a) }
+invalid_eqeqeq:
+    | a='==' b='=' { RAISE_SYNTAX_ERROR_KNOWN_RANGE(a, b, "invalid syntax.  Maybe you meant '==' instead of '==='?") }
 noteq_bitwise_or[CmpopExprPair*]:
     | (tok='!=' { _PyPegen_check_barry_as_flufl(p, tok) ? NULL : tok}) a=bitwise_or {_PyPegen_cmpop_expr_pair(p, NotEq, a) }
 lte_bitwise_or[CmpopExprPair*]: '<=' a=bitwise_or { _PyPegen_cmpop_expr_pair(p, LtE, a) }
@@ -1313,6 +1316,9 @@ invalid_assignment:
             "'%s' is an illegal expression for augmented assignment",
             _PyPegen_get_expr_name(a)
         )}
+    | star_expressions a='=' b='<' { RAISE_SYNTAX_ERROR_KNOWN_RANGE(a, b, "invalid syntax.  Maybe you meant '<=' instead of '=<'?") }
+    | star_expressions a='=' b='>' { RAISE_SYNTAX_ERROR_KNOWN_RANGE(a, b, "invalid syntax.  Maybe you meant '>=' instead of '=>'?") }
+    | star_expressions a='=' b='!' { RAISE_SYNTAX_ERROR_KNOWN_RANGE(a, b, "invalid syntax.  Maybe you meant '!=' instead of '=!'?") }
 invalid_ann_assign_target[expr_ty]:
     | list
     | tuple

Lib/test/test_syntax.py

@@ -3505,6 +3505,46 @@ def test_ifexp_body_stmt_else_stmt(self):
         ]:
             self._check_error(f"x = {lhs_stmt} if 1 else {rhs_stmt}", msg)
 
+    def test_triple_equal(self):
+        self._check_error(
+            "a === b",
+            "Maybe you meant '==' instead of '==='?",
+            lineno=1,
+            end_lineno=1,
+            offset=3,
+            end_offset=6,
+        )
+
+    def test_eq_lt_typo(self):
+        self._check_error(
+            "a =< b",
+            "Maybe you meant '<=' instead of '=<'?",
+            lineno=1,
+            end_lineno=1,
+            offset=3,
+            end_offset=5,
+        )
+
+    def test_eq_gt_typo(self):
+        self._check_error(
+            "a => b",
+            "Maybe you meant '>=' instead of '=>'?",
+            lineno=1,
+            end_lineno=1,
+            offset=3,
+            end_offset=5,
+        )
+
+    def test_eq_bang_typo(self):
+        self._check_error(
+            "a =! b",
+            "Maybe you meant '!=' instead of '=!'?",
+            lineno=1,
+            end_lineno=1,
+            offset=3,
+            end_offset=5,
+        )
+
 
 class LazyImportRestrictionTestCase(SyntaxErrorTestCase):
     """Test syntax restrictions for lazy imports."""

Misc/NEWS.d/next/Core_and_Builtins/2026-06-12-03-41-39.gh-issue-151303.mzlJxi.rst

@@ -0,0 +1 @@
+Improve :exc:`SyntaxError` message for ``===``, ``=<``, ``=>``, and ``=!`` operators, suggesting ``==``, ``<=``, ``>=``, and ``!=`` respectively