✨: add CanArrayIMul protocol

Support in-place multiplication operator for array classes

Author: nstarman

src/array_api_typing/_array.py

@@ -166,6 +166,22 @@ def __mul__(self, other: Self | int | float, /) -> Self:
         ...
 
 
+class CanArrayIMul(Protocol):
+    """Protocol for array classes that support the in-place multiplication operator."""
+
+    def __imul__(self, other: Self | int | float, /) -> Self:
+        """Calculates the in-place product for each element of an array instance with the respective element of the array other.
+
+        Args:
+            other: multiplicand array. Must be compatible with self (see Broadcasting). Should have a numeric data type.
+
+        Returns:
+            Self: after performing the in-place multiplication.
+
+        """  # noqa: E501
+        ...
+
+
 class CanArrayTrueDiv(Protocol):
     """Protocol for array classes that support the true division operator."""
 
@@ -248,6 +264,7 @@ class Array(
     CanArraySub,
     CanArrayISub,
     CanArrayMul,
+    CanArrayIMul,
     CanArrayTrueDiv,
     CanArrayFloorDiv,
     CanArrayMod,