✨: add HasArrayIAnd protocol to support in-place bitwise AND operator for array classes

Author: nstarman

src/array_api_typing/_array.py

@@ -350,6 +350,22 @@ def __and__(self, other: Self | int | float, /) -> Self:
         ...
 
 
+class HasArrayIAnd(Protocol):
+    """Evaluates ``self_i &= other_i`` for each element of an array instance with the respective element of the array other."""  # noqa: E501
+
+    def __iand__(self, other: Self | int | float, /) -> Self:
+        """Calculates the in-place bitwise AND for each element of an array instance with the respective element of the array other.
+
+        Args:
+            other: operand array. Must be compatible with self (see Broadcasting). Should have an integer data type.
+
+        Returns:
+            self, after performing the in-place bitwise AND.
+
+        """  # noqa: E501
+        ...
+
+
 class HasArrayOr(Protocol):
     """Evaluates ``self_i | other_i`` for each element of an array instance with the respective element of the array other."""  # noqa: E501
 
@@ -532,6 +548,7 @@ class Array(
     HasArrayIMatmul,
     HasArrayInvert,
     HasArrayAnd,
+    HasArrayIAnd,
     HasArrayOr,
     HasArrayXOr,
     HasArrayLShift,