SQLAlchemy: Annotate text() (#9498)

Author: srittau

stubs/SQLAlchemy/sqlalchemy/sql/elements.pyi

@@ -1,3 +1,4 @@
+from _typeshed import Incomplete, Self
 from typing import Any, Generic, TypeVar
 from typing_extensions import Literal
 
@@ -136,8 +137,8 @@ class TextClause(
     def __and__(self, other): ...
     key: Any
     text: Any
-    def __init__(self, text, bind: Any | None = ...): ...
-    def bindparams(self, *binds, **names_to_values) -> None: ...
+    def __init__(self, text: str, bind: Incomplete | None = None) -> None: ...
+    def bindparams(self: Self, *binds, **names_to_values) -> Self: ...
     def columns(self, *cols, **types): ...
     @property
     def type(self): ...

stubs/SQLAlchemy/sqlalchemy/sql/expression.pyi

@@ -163,7 +163,9 @@ lateral: Incomplete
 or_: Incomplete
 bindparam: Incomplete
 select: Incomplete
-text: Incomplete
+
+def text(text: str, bind: Incomplete | None = None) -> TextClause: ...
+
 table: Incomplete
 column: Incomplete
 over: Incomplete