plain.models 0.49.1__py3-none-any.whl → 0.50.0__py3-none-any.whl

plain/models/fields/related_descriptors.py

@@ -46,7 +46,10 @@ reverse many-to-one relation.
    ``ReverseManyToManyDescriptor``, use ``ManyToManyDescriptor`` instead.
 """
 
+from __future__ import annotations
+
 from functools import cached_property
+from typing import Any
 
 from plain.models.query import QuerySet
 from plain.models.query_utils import DeferredAttribute
@@ -60,7 +63,7 @@ from .related_managers import (
 
 
 class ForeignKeyDeferredAttribute(DeferredAttribute):
-    def __set__(self, instance, value):
+    def __set__(self, instance: Any, value: Any) -> None:
         if instance.__dict__.get(self.field.attname) != value and self.field.is_cached(
             instance
         ):
@@ -80,11 +83,11 @@ class ForwardManyToOneDescriptor:
     ``Child.parent`` is a ``ForwardManyToOneDescriptor`` instance.
     """
 
-    def __init__(self, field_with_rel):
+    def __init__(self, field_with_rel: Any) -> None:
         self.field = field_with_rel
 
     @cached_property
-    def RelatedObjectDoesNotExist(self):
+    def RelatedObjectDoesNotExist(self) -> type:
         # The exception can't be created at initialization time since the
         # related model might not be resolved yet; `self.field.model` might
         # still be a string model reference.
@@ -97,14 +100,16 @@ class ForwardManyToOneDescriptor:
             },
         )
 
-    def is_cached(self, instance):
+    def is_cached(self, instance: Any) -> bool:
         return self.field.is_cached(instance)
 
     def get_queryset(self) -> QuerySet:
         qs = self.field.remote_field.model._meta.base_queryset
         return qs.all()
 
-    def get_prefetch_queryset(self, instances, queryset=None):
+    def get_prefetch_queryset(
+        self, instances: list[Any], queryset: QuerySet | None = None
+    ) -> tuple[QuerySet, Any, Any, bool, str, bool]:
         if queryset is None:
             queryset = self.get_queryset()
 
@@ -145,12 +150,14 @@ class ForwardManyToOneDescriptor:
             False,
         )
 
-    def get_object(self, instance):
+    def get_object(self, instance: Any) -> Any:
         qs = self.get_queryset()
         # Assuming the database enforces foreign keys, this won't fail.
         return qs.get(self.field.get_reverse_related_filter(instance))
 
-    def __get__(self, instance, cls=None):
+    def __get__(
+        self, instance: Any | None, cls: type | None = None
+    ) -> ForwardManyToOneDescriptor | Any | None:
         """
         Get the related instance through the forward relation.
 
@@ -189,7 +196,7 @@ class ForwardManyToOneDescriptor:
         else:
             return rel_obj
 
-    def __set__(self, instance, value):
+    def __set__(self, instance: Any, value: Any) -> None:
         """
         Set the related instance through the forward relation.
 
@@ -199,9 +206,9 @@ class ForwardManyToOneDescriptor:
         - ``instance`` is the ``child`` instance
         - ``value`` is the ``parent`` instance on the right of the equal sign
         """
-        # If value is a LazyObject (like SimpleLazyObject used for request.user),
-        # force its evaluation. For ForeignKey fields, the value should only be
-        # None or a model instance, never a boolean or other type.
+        # If value is a LazyObject, force its evaluation. For ForeignKey fields,
+        # the value should only be None or a model instance, never a boolean or
+        # other type.
         if isinstance(value, LazyObject):
             # This forces evaluation: if it's None, value becomes None;
             # if it's a User instance, value becomes that instance.
@@ -250,7 +257,7 @@ class ForwardManyToOneDescriptor:
         if value is not None and not remote_field.multiple:
             remote_field.set_cached_value(value, instance)
 
-    def __reduce__(self):
+    def __reduce__(self) -> tuple[Any, tuple[Any, str]]:
         """
         Pickling should return the instance attached by self.field on the
         model, not a new copy of that descriptor. Use getattr() to retrieve
@@ -268,11 +275,13 @@ class RelationDescriptorBase:
     this because they allow direct assignment.
     """
 
-    def __init__(self, rel):
+    def __init__(self, rel: Any) -> None:
         self.rel = rel
         self.field = rel.field
 
-    def __get__(self, instance, cls=None):
+    def __get__(
+        self, instance: Any | None, cls: type | None = None
+    ) -> RelationDescriptorBase | Any:
         """
         Get the related manager when the descriptor is accessed.
 
@@ -282,19 +291,19 @@ class RelationDescriptorBase:
             return self
         return self.get_related_manager(instance)
 
-    def get_related_manager(self, instance):
+    def get_related_manager(self, instance: Any) -> Any:
         """Return the appropriate manager for this relation."""
         raise NotImplementedError(
             f"{self.__class__.__name__} must implement get_related_manager()"
         )
 
-    def _get_set_deprecation_msg_params(self):
+    def _get_set_deprecation_msg_params(self) -> tuple[str, str]:
         """Return parameters for the error message when direct assignment is attempted."""
         raise NotImplementedError(
             f"{self.__class__.__name__} must implement _get_set_deprecation_msg_params()"
         )
 
-    def __set__(self, instance, value):
+    def __set__(self, instance: Any, value: Any) -> None:
         """Prevent direct assignment to the relation."""
         raise TypeError(
             "Direct assignment to the {} is prohibited. Use {}.set() instead.".format(
@@ -318,11 +327,11 @@ class ReverseManyToOneDescriptor(RelationDescriptorBase):
     Most of the implementation is delegated to the ReverseManyToOneManager class.
     """
 
-    def get_related_manager(self, instance):
+    def get_related_manager(self, instance: Any) -> ReverseManyToOneManager:
         """Return the ReverseManyToOneManager for this relation."""
         return ReverseManyToOneManager(instance, self.rel)
 
-    def _get_set_deprecation_msg_params(self):
+    def _get_set_deprecation_msg_params(self) -> tuple[str, str]:
         return (
             "reverse side of a related set",
             self.rel.get_accessor_name(),
@@ -343,17 +352,17 @@ class ForwardManyToManyDescriptor(RelationDescriptorBase):
     """
 
     @property
-    def through(self):
+    def through(self) -> Any:
         # through is provided so that you have easy access to the through
         # model (Book.authors.through) for inlines, etc. This is done as
         # a property to ensure that the fully resolved value is returned.
         return self.rel.through
 
-    def get_related_manager(self, instance):
+    def get_related_manager(self, instance: Any) -> ForwardManyToManyManager:
         """Return the ForwardManyToManyManager for this relation."""
         return ForwardManyToManyManager(instance, self.rel)
 
-    def _get_set_deprecation_msg_params(self):
+    def _get_set_deprecation_msg_params(self) -> tuple[str, str]:
         return (
             "forward side of a many-to-many set",
             self.field.name,
@@ -374,17 +383,17 @@ class ReverseManyToManyDescriptor(RelationDescriptorBase):
     """
 
     @property
-    def through(self):
+    def through(self) -> Any:
         # through is provided so that you have easy access to the through
         # model (Book.authors.through) for inlines, etc. This is done as
         # a property to ensure that the fully resolved value is returned.
         return self.rel.through
 
-    def get_related_manager(self, instance):
+    def get_related_manager(self, instance: Any) -> ReverseManyToManyManager:
         """Return the ReverseManyToManyManager for this relation."""
         return ReverseManyToManyManager(instance, self.rel)
 
-    def _get_set_deprecation_msg_params(self):
+    def _get_set_deprecation_msg_params(self) -> tuple[str, str]:
         return (
             "reverse side of a many-to-many set",
             self.rel.get_accessor_name(),

plain/models/fields/related_lookups.py

@@ -1,3 +1,7 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
 from plain.models.lookups import (
     Exact,
     GreaterThan,
@@ -8,12 +12,16 @@ from plain.models.lookups import (
     LessThanOrEqual,
 )
 
+if TYPE_CHECKING:
+    from plain.models.backends.base.base import BaseDatabaseWrapper
+    from plain.models.sql.compiler import SQLCompiler
+
 
 class MultiColSource:
     contains_aggregate = False
     contains_over_clause = False
 
-    def __init__(self, alias, targets, sources, field):
+    def __init__(self, alias: str, targets: Any, sources: Any, field: Any) -> None:
         self.targets, self.sources, self.field, self.alias = (
             targets,
             sources,
@@ -22,22 +30,22 @@ class MultiColSource:
         )
         self.output_field = self.field
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f"{self.__class__.__name__}({self.alias}, {self.field})"
 
-    def relabeled_clone(self, relabels):
+    def relabeled_clone(self, relabels: dict[str, str]) -> MultiColSource:
         return self.__class__(
             relabels.get(self.alias, self.alias), self.targets, self.sources, self.field
         )
 
-    def get_lookup(self, lookup):
+    def get_lookup(self, lookup: str) -> Any:
         return self.output_field.get_lookup(lookup)
 
-    def resolve_expression(self, *args, **kwargs):
+    def resolve_expression(self, *args: Any, **kwargs: Any) -> MultiColSource:
         return self
 
 
-def get_normalized_value(value, lhs):
+def get_normalized_value(value: Any, lhs: Any) -> tuple[Any, ...]:
     from plain.models import Model
 
     if isinstance(value, Model):
@@ -63,7 +71,7 @@ def get_normalized_value(value, lhs):
 
 
 class RelatedIn(In):
-    def get_prep_lookup(self):
+    def get_prep_lookup(self) -> list[Any]:  # type: ignore[misc]
         if not isinstance(self.lhs, MultiColSource):
             if self.rhs_is_direct_value():
                 # If we get here, we are dealing with single-column relations.
@@ -97,7 +105,9 @@ class RelatedIn(In):
                 self.rhs.set_values([target_field])
         return super().get_prep_lookup()
 
-    def as_sql(self, compiler, connection):
+    def as_sql(
+        self, compiler: SQLCompiler, connection: BaseDatabaseWrapper
+    ) -> tuple[str, list[Any]]:  # type: ignore[misc]
         if isinstance(self.lhs, MultiColSource):
             # For multicolumn lookups we need to build a multicolumn where clause.
             # This clause is either a SubqueryConstraint (for values that need
@@ -139,7 +149,7 @@ class RelatedIn(In):
 
 
 class RelatedLookupMixin:
-    def get_prep_lookup(self):
+    def get_prep_lookup(self) -> Any:  # type: ignore[misc]
         if not isinstance(self.lhs, MultiColSource) and not hasattr(
             self.rhs, "resolve_expression"
         ):
@@ -155,9 +165,11 @@ class RelatedLookupMixin:
                 target_field = self.lhs.output_field.path_infos[-1].target_fields[-1]
                 self.rhs = target_field.get_prep_value(self.rhs)
 
-        return super().get_prep_lookup()
+        return super().get_prep_lookup()  # type: ignore[misc]
 
-    def as_sql(self, compiler, connection):
+    def as_sql(
+        self, compiler: SQLCompiler, connection: BaseDatabaseWrapper
+    ) -> tuple[str, list[Any]]:  # type: ignore[misc]
         if isinstance(self.lhs, MultiColSource):
             assert self.rhs_is_direct_value()
             self.rhs = get_normalized_value(self.rhs, self.lhs)

plain/models/fields/related_managers.py

@@ -5,6 +5,10 @@ These managers provide the API for working with collections of related objects
 through foreign key and many-to-many relationships.
 """
 
+from __future__ import annotations
+
+from typing import Any
+
 from plain.models import transaction
 from plain.models.db import NotSupportedError, db_connection
 from plain.models.expressions import Window
@@ -15,7 +19,9 @@ from plain.models.query_utils import Q
 from plain.models.utils import resolve_callables
 
 
-def _filter_prefetch_queryset(queryset, field_name, instances):
+def _filter_prefetch_queryset(
+    queryset: QuerySet, field_name: str, instances: Any
+) -> QuerySet:
     predicate = Q(**{f"{field_name}__in": instances})
     if queryset.sql_query.is_sliced:
         if not db_connection.features.supports_over_clause:
@@ -28,9 +34,9 @@ def _filter_prefetch_queryset(queryset, field_name, instances):
             expr for expr, _ in queryset.sql_query.get_compiler().get_order_by()
         ]
         window = Window(RowNumber(), partition_by=field_name, order_by=order_by)
-        predicate &= GreaterThan(window, low_mark)
+        predicate &= GreaterThan(window, low_mark)  # type: ignore[unsupported-operator]
         if high_mark is not None:
-            predicate &= LessThanOrEqual(window, high_mark)
+            predicate &= LessThanOrEqual(window, high_mark)  # type: ignore[unsupported-operator]
         queryset.sql_query.clear_limits()
     return queryset.filter(predicate)
 
@@ -59,7 +65,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
     This manager adds behaviors specific to many-to-one relations.
     """
 
-    def __init__(self, instance, rel):
+    def __init__(self, instance: Any, rel: Any):
         self.model = rel.related_model
         self.instance = instance
         self.field = rel.field
@@ -68,7 +74,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
         self.base_queryset_class = rel.related_model._meta.queryset.__class__
         self.allow_null = rel.field.allow_null
 
-    def _check_fk_val(self):
+    def _check_fk_val(self) -> None:
         for field in self.field.foreign_related_fields:
             if getattr(self.instance, field.attname) is None:
                 raise ValueError(
@@ -76,7 +82,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
                     f'"{field.attname}" before this relationship can be used.'
                 )
 
-    def _apply_rel_filters(self, queryset):
+    def _apply_rel_filters(self, queryset: QuerySet) -> QuerySet:
         """
         Filter the queryset for the instance this manager is bound to.
         """
@@ -109,7 +115,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
             queryset._known_related_objects = {self.field: {rel_obj_id: self.instance}}
         return queryset
 
-    def _remove_prefetched_objects(self):
+    def _remove_prefetched_objects(self) -> None:
         try:
             self.instance._prefetched_objects_cache.pop(
                 self.field.remote_field.get_cache_name()
@@ -117,7 +123,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
         except (AttributeError, KeyError):
             pass  # nothing to clear from cache
 
-    def get_queryset(self):
+    def get_queryset(self) -> QuerySet:
         # Even if this relation is not to primary key, we require still primary key value.
         # The wish is that the instance has been already saved to DB,
         # although having a primary key value isn't a guarantee of that.
@@ -135,7 +141,9 @@ class ReverseManyToOneManager(BaseRelatedManager):
             queryset = self.base_queryset_class(model=self.model)
             return self._apply_rel_filters(queryset)
 
-    def get_prefetch_queryset(self, instances, queryset=None):
+    def get_prefetch_queryset(
+        self, instances: Any, queryset: QuerySet | None = None
+    ) -> tuple[QuerySet, Any, Any, bool, str, bool]:
         if queryset is None:
             queryset = self.base_queryset_class(model=self.model)
 
@@ -153,11 +161,11 @@ class ReverseManyToOneManager(BaseRelatedManager):
         cache_name = self.field.remote_field.get_cache_name()
         return queryset, rel_obj_attr, instance_attr, False, cache_name, False
 
-    def add(self, *objs, bulk=True):
+    def add(self, *objs: Any, bulk: bool = True) -> None:
         self._check_fk_val()
         self._remove_prefetched_objects()
 
-        def check_and_update_obj(obj):
+        def check_and_update_obj(obj: Any) -> None:
             if not isinstance(obj, self.model):
                 raise TypeError(
                     f"'{self.model._meta.object_name}' instance expected, got {obj!r}"
@@ -185,22 +193,22 @@ class ReverseManyToOneManager(BaseRelatedManager):
                     check_and_update_obj(obj)
                     obj.save()
 
-    def create(self, **kwargs):
+    def create(self, **kwargs: Any) -> Any:
         self._check_fk_val()
         kwargs[self.field.name] = self.instance
         return self.base_queryset_class(model=self.model).create(**kwargs)
 
-    def get_or_create(self, **kwargs):
+    def get_or_create(self, **kwargs: Any) -> tuple[Any, bool]:
         self._check_fk_val()
         kwargs[self.field.name] = self.instance
         return self.base_queryset_class(model=self.model).get_or_create(**kwargs)
 
-    def update_or_create(self, **kwargs):
+    def update_or_create(self, **kwargs: Any) -> tuple[Any, bool]:
         self._check_fk_val()
         kwargs[self.field.name] = self.instance
         return self.base_queryset_class(model=self.model).update_or_create(**kwargs)
 
-    def remove(self, *objs, bulk=True):
+    def remove(self, *objs: Any, bulk: bool = True) -> None:
         # remove() is only provided if the ForeignKey can have a value of null
         if not self.allow_null:
             raise AttributeError(
@@ -226,7 +234,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
                 )
         self._clear(self.query.filter(id__in=old_ids), bulk)
 
-    def clear(self, *, bulk=True):
+    def clear(self, *, bulk: bool = True) -> None:
         # clear() is only provided if the ForeignKey can have a value of null
         if not self.allow_null:
             raise AttributeError(
@@ -236,7 +244,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
         self._check_fk_val()
         self._clear(self.query, bulk)
 
-    def _clear(self, queryset, bulk):
+    def _clear(self, queryset: QuerySet, bulk: bool) -> None:
         self._remove_prefetched_objects()
         if bulk:
             # `QuerySet.update()` is intrinsically atomic.
@@ -247,7 +255,7 @@ class ReverseManyToOneManager(BaseRelatedManager):
                     setattr(obj, self.field.name, None)
                     obj.save(update_fields=[self.field.name])
 
-    def set(self, objs, *, bulk=True, clear=False):
+    def set(self, objs: Any, *, bulk: bool = True, clear: bool = False) -> None:
         self._check_fk_val()
         # Force evaluation of `objs` in case it's a queryset whose value
         # could be affected by `manager.clear()`. Refs #19816.
@@ -286,7 +294,7 @@ class BaseManyToManyManager(BaseRelatedManager):
     - symmetrical (for forward relations)
     """
 
-    def __init__(self, instance, rel):
+    def __init__(self, instance: Any, rel: Any):
         self.instance = instance
         self.through = rel.through
         # Subclasses must set model before calling super().__init__
@@ -315,12 +323,12 @@ class BaseManyToManyManager(BaseRelatedManager):
                 "a many-to-many relationship can be used."
             )
 
-    def _apply_rel_filters(self, queryset):
+    def _apply_rel_filters(self, queryset: QuerySet) -> QuerySet:
         """Filter the queryset for the instance this manager is bound to."""
         queryset._defer_next_filter = True
         return queryset._next_is_sticky().filter(**self.core_filters)
 
-    def _remove_prefetched_objects(self):
+    def _remove_prefetched_objects(self) -> None:
         try:
             self.instance._prefetched_objects_cache.pop(self.prefetch_cache_name)
         except (AttributeError, KeyError):
@@ -333,7 +341,9 @@ class BaseManyToManyManager(BaseRelatedManager):
             queryset = self.base_queryset_class(model=self.model)
             return self._apply_rel_filters(queryset)
 
-    def get_prefetch_queryset(self, instances, queryset=None):
+    def get_prefetch_queryset(
+        self, instances: Any, queryset: QuerySet | None = None
+    ) -> tuple[QuerySet, Any, Any, bool, str, bool]:
         if queryset is None:
             queryset = self.base_queryset_class(model=self.model)
 
@@ -367,7 +377,7 @@ class BaseManyToManyManager(BaseRelatedManager):
             False,
         )
 
-    def clear(self):
+    def clear(self) -> None:
         with transaction.atomic(savepoint=False):
             self._remove_prefetched_objects()
             filters = self._build_remove_filters(
@@ -375,7 +385,13 @@ class BaseManyToManyManager(BaseRelatedManager):
             )
             self.through.query.filter(filters).delete()
 
-    def set(self, objs, *, clear=False, through_defaults=None):
+    def set(
+        self,
+        objs: Any,
+        *,
+        clear: bool = False,
+        through_defaults: dict[str, Any] | None = None,
+    ) -> None:
         # Force evaluation of `objs` in case it's a queryset whose value
         # could be affected by `manager.clear()`. Refs #19816.
         objs = tuple(objs)
@@ -406,12 +422,16 @@ class BaseManyToManyManager(BaseRelatedManager):
                 self.remove(*old_ids)
                 self.add(*new_objs, through_defaults=through_defaults)
 
-    def create(self, *, through_defaults=None, **kwargs):
+    def create(
+        self, *, through_defaults: dict[str, Any] | None = None, **kwargs: Any
+    ) -> Any:
         new_obj = self.base_queryset_class(model=self.model).create(**kwargs)
         self.add(new_obj, through_defaults=through_defaults)
         return new_obj
 
-    def get_or_create(self, *, through_defaults=None, **kwargs):
+    def get_or_create(
+        self, *, through_defaults: dict[str, Any] | None = None, **kwargs: Any
+    ) -> tuple[Any, bool]:
         obj, created = self.base_queryset_class(model=self.model).get_or_create(
             **kwargs
         )
@@ -421,7 +441,9 @@ class BaseManyToManyManager(BaseRelatedManager):
             self.add(obj, through_defaults=through_defaults)
         return obj, created
 
-    def update_or_create(self, *, through_defaults=None, **kwargs):
+    def update_or_create(
+        self, *, through_defaults: dict[str, Any] | None = None, **kwargs: Any
+    ) -> tuple[Any, bool]:
         obj, created = self.base_queryset_class(model=self.model).update_or_create(
             **kwargs
         )
@@ -431,7 +453,7 @@ class BaseManyToManyManager(BaseRelatedManager):
             self.add(obj, through_defaults=through_defaults)
         return obj, created
 
-    def _get_target_ids(self, target_field_name, objs):
+    def _get_target_ids(self, target_field_name: str, objs: Any) -> set[Any]:
         """Return the set of ids of `objs` that the target field references."""
         from plain.models import Model
 
@@ -453,7 +475,9 @@ class BaseManyToManyManager(BaseRelatedManager):
                 target_ids.add(target_field.get_prep_value(obj))
         return target_ids
 
-    def _get_missing_target_ids(self, source_field_name, target_field_name, target_ids):
+    def _get_missing_target_ids(
+        self, source_field_name: str, target_field_name: str, target_ids: set[Any]
+    ) -> set[Any]:
         """Return the subset of ids of `objs` that aren't already assigned to this relationship."""
         vals = self.through.query.values_list(target_field_name, flat=True).filter(
             **{
@@ -464,8 +488,12 @@ class BaseManyToManyManager(BaseRelatedManager):
         return target_ids.difference(vals)
 
     def _add_items(
-        self, source_field_name, target_field_name, *objs, through_defaults=None
-    ):
+        self,
+        source_field_name: str,
+        target_field_name: str,
+        *objs: Any,
+        through_defaults: dict[str, Any] | None = None,
+    ) -> None:
         if not objs:
             return
 
@@ -490,7 +518,9 @@ class BaseManyToManyManager(BaseRelatedManager):
                 ],
             )
 
-    def _remove_items(self, source_field_name, target_field_name, *objs):
+    def _remove_items(
+        self, source_field_name: str, target_field_name: str, *objs: Any
+    ) -> None:
         if not objs:
             return
 
@@ -515,13 +545,13 @@ class BaseManyToManyManager(BaseRelatedManager):
             self.through.query.filter(filters).delete()
 
     # Subclasses must implement these methods:
-    def _build_remove_filters(self, removed_vals):
+    def _build_remove_filters(self, removed_vals: Any) -> Any:
         raise NotImplementedError
 
-    def add(self, *objs, through_defaults=None):
+    def add(self, *objs: Any, through_defaults: dict[str, Any] | None = None) -> None:
         raise NotImplementedError
 
-    def remove(self, *objs):
+    def remove(self, *objs: Any) -> None:
         raise NotImplementedError
 
 
@@ -532,7 +562,7 @@ class ForwardManyToManyManager(BaseManyToManyManager):
     This manager adds behaviors specific to many-to-many relations.
     """
 
-    def __init__(self, instance, rel):
+    def __init__(self, instance: Any, rel: Any):
         # Set required attributes before calling super().__init__
         self.model = rel.model
         self.query_field_name = rel.field.related_query_name()
@@ -543,7 +573,7 @@ class ForwardManyToManyManager(BaseManyToManyManager):
 
         super().__init__(instance, rel)
 
-    def _build_remove_filters(self, removed_vals):
+    def _build_remove_filters(self, removed_vals: Any) -> Any:
         filters = Q.create([(self.source_field_name, self.related_val)])
         # No need to add a subquery condition if removed_vals is a QuerySet without
         # filters.
@@ -551,17 +581,19 @@ class ForwardManyToManyManager(BaseManyToManyManager):
             not isinstance(removed_vals, QuerySet) or removed_vals._has_filters()
         )
         if removed_vals_filters:
-            filters &= Q.create([(f"{self.target_field_name}__in", removed_vals)])
+            filters = filters & Q.create(  # type: ignore[unsupported-operator]
+                [(f"{self.target_field_name}__in", removed_vals)]
+            )
         if self.symmetrical:
             symmetrical_filters = Q.create([(self.target_field_name, self.related_val)])
             if removed_vals_filters:
-                symmetrical_filters &= Q.create(
+                symmetrical_filters = symmetrical_filters & Q.create(  # type: ignore[unsupported-operator]
                     [(f"{self.source_field_name}__in", removed_vals)]
                 )
-            filters |= symmetrical_filters
+            filters = filters | symmetrical_filters  # type: ignore[unsupported-operator]
         return filters
 
-    def add(self, *objs, through_defaults=None):
+    def add(self, *objs: Any, through_defaults: dict[str, Any] | None = None) -> None:
         self._remove_prefetched_objects()
         with transaction.atomic(savepoint=False):
             self._add_items(
@@ -580,7 +612,7 @@ class ForwardManyToManyManager(BaseManyToManyManager):
                     through_defaults=through_defaults,
                 )
 
-    def remove(self, *objs):
+    def remove(self, *objs: Any) -> None:
         self._remove_prefetched_objects()
         self._remove_items(self.source_field_name, self.target_field_name, *objs)
 
@@ -592,7 +624,7 @@ class ReverseManyToManyManager(BaseManyToManyManager):
     This manager adds behaviors specific to many-to-many relations.
     """
 
-    def __init__(self, instance, rel):
+    def __init__(self, instance: Any, rel: Any):
         # Set required attributes before calling super().__init__
         self.model = rel.related_model
         self.query_field_name = rel.field.name
@@ -603,7 +635,7 @@ class ReverseManyToManyManager(BaseManyToManyManager):
 
         super().__init__(instance, rel)
 
-    def _build_remove_filters(self, removed_vals):
+    def _build_remove_filters(self, removed_vals: Any) -> Any:
         filters = Q.create([(self.source_field_name, self.related_val)])
         # No need to add a subquery condition if removed_vals is a QuerySet without
         # filters.
@@ -611,11 +643,13 @@ class ReverseManyToManyManager(BaseManyToManyManager):
             not isinstance(removed_vals, QuerySet) or removed_vals._has_filters()
         )
         if removed_vals_filters:
-            filters &= Q.create([(f"{self.target_field_name}__in", removed_vals)])
+            filters = filters & Q.create(  # type: ignore[unsupported-operator]
+                [(f"{self.target_field_name}__in", removed_vals)]
+            )
         # Note: reverse relations are never symmetrical, so no symmetrical logic here
         return filters
 
-    def add(self, *objs, through_defaults=None):
+    def add(self, *objs: Any, through_defaults: dict[str, Any] | None = None) -> None:
         self._remove_prefetched_objects()
         with transaction.atomic(savepoint=False):
             self._add_items(
@@ -626,6 +660,6 @@ class ReverseManyToManyManager(BaseManyToManyManager):
             )
             # Reverse relations are never symmetrical, so no mirror entry logic
 
-    def remove(self, *objs):
+    def remove(self, *objs: Any) -> None:
         self._remove_prefetched_objects()
         self._remove_items(self.source_field_name, self.target_field_name, *objs)