feat: HasDevice

Signed-off-by: nstarman <[email protected]>

Author: nstarman

pyproject.toml

@@ -130,6 +130,8 @@ ignore = [
   "ISC001", # Conflicts with formatter
   "PLW1641", # Object does not implement `__hash__` method
   "PYI041", # Use `float` instead of `int | float`
+  "TD002", # Missing author in TODO
+  "TD003", # Missing issue link for this TOOD
 ]
 
 [tool.ruff.lint.pylint]

src/array_api_typing/_array.py

@@ -62,10 +62,20 @@ def dtype(self) -> DType_co:
         ...
 
 
+class HasDevice(Protocol):
+    """Protocol for array classes that have a device attribute."""
+
+    @property
+    def device(self) -> object:  # TODO: more specific type
+        """Hardware device the array data resides on."""
+        ...
+
+
 @docstring_setter(**_array_docstrings)
 class Array(
     # ------ Attributes -------
     HasDType[DType_co],
+    HasDevice,
     # ------ Methods -------
     HasArrayNamespace[NS_co],
     op.CanPosSelf,