Fix relationship.order_by typing

Fixes: #8776

diff --git a/doc/build/changelog/unreleased_20/8776.rst b/doc/build/changelog/unreleased_20/8776.rst
new file mode 100644 (file)
index 0000000..fa4156e
--- /dev/null
+++ b/doc/build/changelog/unreleased_20/8776.rst
@@ -0,0 +1,7 @@
+.. change::
+    :tags: bug, orm
+    :tickets: 8776
+
+    Fixed issue where passing a callbale function returning an iterable
+    of column elements to :paramref:`_orm.relationship.order_by` was
+    flagged as an error in type checkers.

diff --git a/lib/sqlalchemy/orm/relationships.py b/lib/sqlalchemy/orm/relationships.py
index e0922a5380f7a3ae90990726bdb5a9b8ef6be740..986093e02533e80c0dd9a385fb5dbf589712e0e9 100644 (file)
--- a/lib/sqlalchemy/orm/relationships.py
+++ b/lib/sqlalchemy/orm/relationships.py
@@ -164,6 +164,7 @@ _ORMOrderByArgument = Union[
     Literal[False],
     str,
     _ColumnExpressionArgument[Any],
+    Callable[[], Iterable[ColumnElement[Any]]],
     Iterable[Union[str, _ColumnExpressionArgument[Any]]],
 ]
 _ORMBackrefArgument = Union[str, Tuple[str, Dict[str, Any]]]