✨: add CanArrayPos protocol

Author: nstarman

pyproject.toml

@@ -127,6 +127,7 @@ version_tuple = {version_tuple!r}
       "D107",   # Missing docstring in __init__
       "D203",   # 1 blank line required before class docstring
       "D213",   # Multi-line docstring summary should start at the second line
+      "D401",   # First line of docstring should be in imperative mood
       "FBT",    # flake8-boolean-trap
       "FIX",    # flake8-fixme
       "ISC001", # Conflicts with formatter

src/array_api_typing/_array.py

@@ -5,7 +5,7 @@
 
 from types import ModuleType
 from typing import Literal, Protocol
-from typing_extensions import TypeVar
+from typing_extensions import Self, TypeVar
 
 NS_co = TypeVar("NS_co", covariant=True, default=ModuleType)
 
@@ -33,8 +33,26 @@ def __array_namespace__(
     ) -> NS_co: ...
 
 
+class CanArrayPos(Protocol):
+    """Protocol for array classes that support the unary plus operator."""
+
+    def __pos__(self) -> Self:
+        """Evaluates `+self_i` for each element of an array instance.
+
+        Returns:
+            Self: An array containing the evaluated result for each element.
+            The returned array must have the same data type as self.
+
+        See Also:
+            array_api_typing.Positive
+
+        """
+        ...
+
+
 class Array(
     HasArrayNamespace[NS_co],
+    CanArrayPos,
     Protocol,
 ):
     """Array API specification for array object attributes and methods."""