main commit

venv/lib/python3.12/site-packages/sqlalchemy/orm/attributes.py

@@ -1,5 +1,5 @@
 # orm/attributes.py
-# Copyright (C) 2005-2025 the SQLAlchemy authors and contributors
+# Copyright (C) 2005-2023 the SQLAlchemy authors and contributors
 # <see AUTHORS file>
 #
 # This module is part of SQLAlchemy and is released under
@@ -401,7 +401,7 @@ class QueryableAttribute(
             parententity=adapt_to_entity,
         )
 
-    def of_type(self, entity: _EntityType[_T]) -> QueryableAttribute[_T]:
+    def of_type(self, entity: _EntityType[Any]) -> QueryableAttribute[_T]:
         return QueryableAttribute(
             self.class_,
             self.key,
@@ -462,9 +462,6 @@ class QueryableAttribute(
     ) -> bool:
         return self.impl.hasparent(state, optimistic=optimistic) is not False
 
-    def _column_strategy_attrs(self) -> Sequence[QueryableAttribute[Any]]:
-        return (self,)
-
     def __getattr__(self, key: str) -> Any:
         try:
             return util.MemoizedSlots.__getattr__(self, key)
@@ -506,7 +503,7 @@ def _queryable_attribute_unreduce(
         return getattr(entity, key)
 
 
-class InstrumentedAttribute(QueryableAttribute[_T_co]):
+class InstrumentedAttribute(QueryableAttribute[_T]):
     """Class bound instrumented attribute which adds basic
     :term:`descriptor` methods.
 
@@ -545,16 +542,16 @@ class InstrumentedAttribute(QueryableAttribute[_T_co]):
         self.impl.delete(instance_state(instance), instance_dict(instance))
 
     @overload
-    def __get__(
-        self, instance: None, owner: Any
-    ) -> InstrumentedAttribute[_T_co]: ...
+    def __get__(self, instance: None, owner: Any) -> InstrumentedAttribute[_T]:
+        ...
 
     @overload
-    def __get__(self, instance: object, owner: Any) -> _T_co: ...
+    def __get__(self, instance: object, owner: Any) -> _T:
+        ...
 
     def __get__(
         self, instance: Optional[object], owner: Any
-    ) -> Union[InstrumentedAttribute[_T_co], _T_co]:
+    ) -> Union[InstrumentedAttribute[_T], _T]:
         if instance is None:
             return self
 
@@ -598,7 +595,7 @@ def create_proxied_attribute(
     # TODO: can move this to descriptor_props if the need for this
     # function is removed from ext/hybrid.py
 
-    class Proxy(QueryableAttribute[_T_co]):
+    class Proxy(QueryableAttribute[Any]):
         """Presents the :class:`.QueryableAttribute` interface as a
         proxy on top of a Python descriptor / :class:`.PropComparator`
         combination.
@@ -613,13 +610,13 @@ def create_proxied_attribute(
 
         def __init__(
             self,
-            class_: _ExternalEntityType[Any],
-            key: str,
-            descriptor: Any,
-            comparator: interfaces.PropComparator[_T_co],
-            adapt_to_entity: Optional[AliasedInsp[Any]] = None,
-            doc: Optional[str] = None,
-            original_property: Optional[QueryableAttribute[_T_co]] = None,
+            class_,
+            key,
+            descriptor,
+            comparator,
+            adapt_to_entity=None,
+            doc=None,
+            original_property=None,
         ):
             self.class_ = class_
             self.key = key
@@ -630,11 +627,11 @@ def create_proxied_attribute(
             self._doc = self.__doc__ = doc
 
         @property
-        def _parententity(self):  # type: ignore[override]
+        def _parententity(self):
             return inspection.inspect(self.class_, raiseerr=False)
 
         @property
-        def parent(self):  # type: ignore[override]
+        def parent(self):
             return inspection.inspect(self.class_, raiseerr=False)
 
         _is_internal_proxy = True
@@ -644,13 +641,6 @@ def create_proxied_attribute(
             ("_parententity", visitors.ExtendedInternalTraversal.dp_multi),
         ]
 
-        def _column_strategy_attrs(self) -> Sequence[QueryableAttribute[Any]]:
-            prop = self.original_property
-            if prop is None:
-                return ()
-            else:
-                return prop._column_strategy_attrs()
-
         @property
         def _impl_uses_objects(self):
             return (
@@ -1548,7 +1538,8 @@ class HasCollectionAdapter:
         dict_: _InstanceDict,
         user_data: Literal[None] = ...,
         passive: Literal[PassiveFlag.PASSIVE_OFF] = ...,
-    ) -> CollectionAdapter: ...
+    ) -> CollectionAdapter:
+        ...
 
     @overload
     def get_collection(
@@ -1557,7 +1548,8 @@ class HasCollectionAdapter:
         dict_: _InstanceDict,
         user_data: _AdaptedCollectionProtocol = ...,
         passive: PassiveFlag = ...,
-    ) -> CollectionAdapter: ...
+    ) -> CollectionAdapter:
+        ...
 
     @overload
     def get_collection(
@@ -1568,7 +1560,8 @@ class HasCollectionAdapter:
         passive: PassiveFlag = ...,
     ) -> Union[
         Literal[LoaderCallableStatus.PASSIVE_NO_RESULT], CollectionAdapter
-    ]: ...
+    ]:
+        ...
 
     def get_collection(
         self,
@@ -1599,7 +1592,8 @@ if TYPE_CHECKING:
 
     def _is_collection_attribute_impl(
         impl: AttributeImpl,
-    ) -> TypeGuard[CollectionAttributeImpl]: ...
+    ) -> TypeGuard[CollectionAttributeImpl]:
+        ...
 
 else:
     _is_collection_attribute_impl = operator.attrgetter("collection")
@@ -2055,7 +2049,8 @@ class CollectionAttributeImpl(HasCollectionAdapter, AttributeImpl):
         dict_: _InstanceDict,
         user_data: Literal[None] = ...,
         passive: Literal[PassiveFlag.PASSIVE_OFF] = ...,
-    ) -> CollectionAdapter: ...
+    ) -> CollectionAdapter:
+        ...
 
     @overload
     def get_collection(
@@ -2064,7 +2059,8 @@ class CollectionAttributeImpl(HasCollectionAdapter, AttributeImpl):
         dict_: _InstanceDict,
         user_data: _AdaptedCollectionProtocol = ...,
         passive: PassiveFlag = ...,
-    ) -> CollectionAdapter: ...
+    ) -> CollectionAdapter:
+        ...
 
     @overload
     def get_collection(
@@ -2075,7 +2071,8 @@ class CollectionAttributeImpl(HasCollectionAdapter, AttributeImpl):
         passive: PassiveFlag = PASSIVE_OFF,
     ) -> Union[
         Literal[LoaderCallableStatus.PASSIVE_NO_RESULT], CollectionAdapter
-    ]: ...
+    ]:
+        ...
 
     def get_collection(
         self,
@@ -2673,7 +2670,7 @@ def init_collection(obj: object, key: str) -> CollectionAdapter:
     This function is used to provide direct access to collection internals
     for a previously unloaded attribute.  e.g.::
 
-        collection_adapter = init_collection(someobject, "elements")
+        collection_adapter = init_collection(someobject, 'elements')
         for elem in values:
             collection_adapter.append_without_event(elem)
 
@@ -2717,7 +2714,7 @@ def init_state_collection(
     return adapter
 
 
-def set_committed_value(instance: object, key: str, value: Any) -> None:
+def set_committed_value(instance, key, value):
     """Set the value of an attribute with no history events.
 
     Cancels any previous history present.  The value should be