✨: add CanArrayPos protocol

Author: nstarman

pyproject.toml

@@ -133,6 +133,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 Protocol
-from typing_extensions import TypeVar
+from typing_extensions import Self, TypeVar
 
 NS_co = TypeVar("NS_co", covariant=True, bound=object, default=ModuleType)
 
@@ -31,8 +31,26 @@ class HasArrayNamespace(Protocol[NS_co]):
     def __array_namespace__(self, /, *, api_version: str | None = None) -> NS_co: ...  # noqa: PLW3201
 
 
+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."""